@synap-core/workspace-templates 0.6.3 → 0.6.4

package/dist/index.d.ts

@@ -652,6 +652,48 @@ interface AssembleCatalogInput {
  * per-source `isPrivate` control (e.g. keeping browse and `/mine` distinct).
  */
 declare function assembleCatalog(input: AssembleCatalogInput): MergeCatalogResult;
+/** A template a pod has installed — the door reads `settings.packageVersion` off the workspace row. */
+interface InstalledTemplate {
+    slug: string;
+    version: string;
+}
+/** Per-slug verdict: is a newer catalog version available than what's installed? */
+interface TemplateUpdateCheck {
+    slug: string;
+    installedVersion: string;
+    /** `undefined` when the slug has no matching catalog entry, or a bundled winner and no `bundleVersion` was passed. */
+    latestVersion: string | undefined;
+    updateAvailable: boolean;
+    /** Passed through from the winning catalog entry, so callers can route private updates through the authed path. */
+    isPrivate?: boolean;
+}
+/**
+ * `true` when `version` is a CP content-hash stamp (`"h-<hash>"`) rather than semver.
+ * Content-hash versions are NOT semver-comparable — see `computeTemplateUpdates`.
+ */
+declare function isHashVersion(version: string | undefined): boolean;
+/**
+ * Compute, per installed template, whether the CATALOG (bundled + remote,
+ * already merged by `mergeCatalog`/`assembleCatalog`) carries a newer version
+ * than what the pod installed — the shared "update available" check all three
+ * doors (browser, synap-app, CLI) reuse instead of re-deriving it.
+ *
+ * `installed` and `catalog` are BOTH already-fetched/computed by the caller —
+ * this stays PURE, same as the rest of this module (no fetch, no auth).
+ *
+ * The catalog's winning entry carries the latest version signal two ways:
+ *   • `source: "remote"` → `remote.definition?.sourcePackage?.version` (semver
+ *     OR, going forward, a CP content-hash `"h-<hash>"` stamp).
+ *   • `source: "bundled"` → bundled entries carry no version field at all
+ *     (`TemplateMeta` has none); pass `bundleVersion` (this client's compiled
+ *     package version, the same value fed to `mergeCatalog`) to compare against
+ *     it. Omit `bundleVersion` and bundled-backed slugs report `latestVersion:
+ *     undefined, updateAvailable: false` (nothing comparable).
+ *
+ * A slug with no matching catalog entry ⇒ `updateAvailable: false`,
+ * `latestVersion: undefined` — there is nothing to update TO.
+ */
+declare function computeTemplateUpdates(installed: InstalledTemplate[], catalog: CatalogEntry[], bundleVersion?: string): TemplateUpdateCheck[];
 
 /**
  * @synap-core/workspace-templates — Definition adapter
@@ -810,4 +852,4 @@ interface PackageDefinitionOutput {
  */
 declare function toPackageDefinition(slugOrYaml: string | WorkspaceYaml): PackageDefinitionOutput;
 
-export { type AssembleCatalogInput, type BentoViewBlockWire, type BentoWidgetBlockWire, type BundledCatalogEntry, type BundledEntry, type CatalogEntry, type CpPackageRow, type MergeCatalogInput, type MergeCatalogResult, PACKAGE_DEPENDENCY_KINDS, type PackageDefinitionOutput, type PackageDependencyKind, type RemoteCatalogEntry, type RemoteEntry, type RemoteSourceStatus, type SplitBentoBlocks, type TemplateAppKind, type TemplateAppRef, type TemplateBentoBlock, type TemplateDefaultSource, type TemplateDependency, type TemplateDisplayTemplate, type TemplateEntityLink, type TemplateExtendsRef, type TemplateIntegration, type TemplateLayoutConfig, type TemplateMeta, type TemplateOnboarding, type TemplateOnboardingCollectTarget, type TemplatePlaybook, type TemplatePlaybookParam, type TemplateProfile, type TemplateProfileEntityBentoTemplates, type TemplateProperty, type TemplateSeedEntity, type TemplateSidebarItem, type TemplateSidebarSurface, type TemplateSourceRole, type TemplateSuggestedRelation, type TemplateView, type ToDefinitionResult, WORKSPACE_TEMPLATES, type WorkspaceDefinitionInput, type WorkspaceTemplateSlug, type WorkspaceYaml, assembleCatalog, getWorkspaceTemplate, listPublicTemplates, listWorkspaceTemplates, mergeCatalog, rowToRemoteEntry, splitBentoBlocks, toPackageDefinition, toWorkspaceDefinition };
+export { type AssembleCatalogInput, type BentoViewBlockWire, type BentoWidgetBlockWire, type BundledCatalogEntry, type BundledEntry, type CatalogEntry, type CpPackageRow, type InstalledTemplate, type MergeCatalogInput, type MergeCatalogResult, PACKAGE_DEPENDENCY_KINDS, type PackageDefinitionOutput, type PackageDependencyKind, type RemoteCatalogEntry, type RemoteEntry, type RemoteSourceStatus, type SplitBentoBlocks, type TemplateAppKind, type TemplateAppRef, type TemplateBentoBlock, type TemplateDefaultSource, type TemplateDependency, type TemplateDisplayTemplate, type TemplateEntityLink, type TemplateExtendsRef, type TemplateIntegration, type TemplateLayoutConfig, type TemplateMeta, type TemplateOnboarding, type TemplateOnboardingCollectTarget, type TemplatePlaybook, type TemplatePlaybookParam, type TemplateProfile, type TemplateProfileEntityBentoTemplates, type TemplateProperty, type TemplateSeedEntity, type TemplateSidebarItem, type TemplateSidebarSurface, type TemplateSourceRole, type TemplateSuggestedRelation, type TemplateUpdateCheck, type TemplateView, type ToDefinitionResult, WORKSPACE_TEMPLATES, type WorkspaceDefinitionInput, type WorkspaceTemplateSlug, type WorkspaceYaml, assembleCatalog, computeTemplateUpdates, getWorkspaceTemplate, isHashVersion, listPublicTemplates, listWorkspaceTemplates, mergeCatalog, rowToRemoteEntry, splitBentoBlocks, toPackageDefinition, toWorkspaceDefinition };

package/dist/index.js

@@ -25136,6 +25136,33 @@ function assembleCatalog(input) {
     remoteStatus: input.remoteStatus
   });
 }
+function isHashVersion(version) {
+  return typeof version === "string" && version.startsWith("h-");
+}
+function isNewerVersion(installedVersion, latestVersion) {
+  if (latestVersion === void 0) return false;
+  if (isHashVersion(installedVersion) || isHashVersion(latestVersion)) {
+    return installedVersion !== latestVersion;
+  }
+  return remoteIsStrictlyNewer(latestVersion, installedVersion);
+}
+function computeTemplateUpdates(installed, catalog, bundleVersion) {
+  const bySlug = new Map(catalog.map((entry) => [entry.slug, entry]));
+  return installed.map(({ slug, version: installedVersion }) => {
+    const entry = bySlug.get(slug);
+    if (!entry) {
+      return { slug, installedVersion, latestVersion: void 0, updateAvailable: false };
+    }
+    const latestVersion = entry.source === "remote" ? entry.remote.definition?.sourcePackage?.version : bundleVersion;
+    return {
+      slug,
+      installedVersion,
+      latestVersion,
+      updateAvailable: isNewerVersion(installedVersion, latestVersion),
+      isPrivate: entry.isPrivate
+    };
+  });
+}
 
 // src/define.ts
 function resolveBlockKind(block) {
@@ -25264,7 +25291,9 @@ export {
   PACKAGE_DEPENDENCY_KINDS,
   WORKSPACE_TEMPLATES,
   assembleCatalog,
+  computeTemplateUpdates,
   getWorkspaceTemplate,
+  isHashVersion,
   listPublicTemplates,
   listWorkspaceTemplates,
   mergeCatalog,