@zhama/tego-plugin-sdk 1.36.1 → 1.37.0

package/dist/{manifest-types-DQARCQJt.d.cts → manifest-types-CUTNfJTa.d.cts}

@@ -624,4 +624,4 @@ interface ResolvedPluginParts {
  */
 declare function resolvePluginParts(manifest: TegoPluginManifest): ResolvedPluginParts;
 
-export { resolvePluginParts as $, type PluginConfigDeclaration as A, type PluginConfigFieldSchema as B, CLAW_MANIFEST_FILENAME as C, type PluginConfigFieldType as D, EMPTY_CONFIG_SECTION_SUMMARY as E, type PluginConfigSchema as F, type PluginConfigUiHint as G, type PluginFrontendPart as H, type PluginParts as I, type PluginPermissions as J, type PluginPublicFrontendPart as K, type LocalizedText as L, type PluginPublicRouteMethod as M, type PluginSchemaRepair as N, type PluginWorkDelegationDeclaration as O, type PluginPublicRoute as P, type ResolvedClawPart as Q, type ResolvedBackendPart as R, type ResolvedFrontendPart as S, type TegoPluginManifest as T, type ResolvedPluginParts as U, type ResolvedPublicFrontendPart as V, applyConfigDefaults as W, configFieldLabel as X, declaredPartNames as Y, redactSecrets as Z, resolvePluginDeclares as _, type PluginBackendRuntime as a, resolvePluginScope as a0, restoreSecrets as a1, summarizeClawConfig as a2, summarizeConfigDeclaration as a3, type PluginScope as b, type PluginPartName as c, type PluginDeclares as d, type PluginConfigSection as e, type PluginConfigSectionSummary as f, type PluginNavIcon as g, type PluginNavEntry as h, type PluginAgentReadinessDeclaration as i, PLUGIN_BACKEND_PLATFORMS as j, PLUGIN_BACKEND_RUNTIMES as k, PLUGIN_CONFIG_SECRET_SENTINEL as l, PLUGIN_CONFIG_SECTIONS as m, PLUGIN_MANIFEST_FILENAME as n, PLUGIN_NAV_ICONS as o, PLUGIN_NAV_ICON_FALLBACK as p, PLUGIN_PART_DEFAULTS as q, PLUGIN_PART_NAMES as r, type PluginAgentReadinessItem as s, type PluginAgentReadinessResponse as t, type PluginAuditDeclarations as u, type PluginAuditToolDeclaration as v, type PluginBackendLimits as w, type PluginBackendPart as x, type PluginBackendPlatform as y, type PluginClawPart as z };
+export { resolvePluginParts as $, type PluginConfigDeclaration as A, type PluginConfigFieldSchema as B, CLAW_MANIFEST_FILENAME as C, type PluginConfigFieldType as D, EMPTY_CONFIG_SECTION_SUMMARY as E, type PluginConfigSchema as F, type PluginConfigUiHint as G, type PluginFrontendPart as H, type PluginParts as I, type PluginPermissions as J, type PluginPublicFrontendPart as K, type LocalizedText as L, type PluginPublicRouteMethod as M, type PluginSchemaRepair as N, type PluginWorkDelegationDeclaration as O, type PluginNavEntry as P, type ResolvedClawPart as Q, type ResolvedBackendPart as R, type ResolvedFrontendPart as S, type TegoPluginManifest as T, type ResolvedPluginParts as U, type ResolvedPublicFrontendPart as V, applyConfigDefaults as W, configFieldLabel as X, declaredPartNames as Y, redactSecrets as Z, resolvePluginDeclares as _, type PluginPublicRoute as a, resolvePluginScope as a0, restoreSecrets as a1, summarizeClawConfig as a2, summarizeConfigDeclaration as a3, type PluginBackendRuntime as b, type PluginScope as c, type PluginPartName as d, type PluginDeclares as e, type PluginConfigSection as f, type PluginConfigSectionSummary as g, type PluginNavIcon as h, type PluginAgentReadinessDeclaration as i, PLUGIN_BACKEND_PLATFORMS as j, PLUGIN_BACKEND_RUNTIMES as k, PLUGIN_CONFIG_SECRET_SENTINEL as l, PLUGIN_CONFIG_SECTIONS as m, PLUGIN_MANIFEST_FILENAME as n, PLUGIN_NAV_ICONS as o, PLUGIN_NAV_ICON_FALLBACK as p, PLUGIN_PART_DEFAULTS as q, PLUGIN_PART_NAMES as r, type PluginAgentReadinessItem as s, type PluginAgentReadinessResponse as t, type PluginAuditDeclarations as u, type PluginAuditToolDeclaration as v, type PluginBackendLimits as w, type PluginBackendPart as x, type PluginBackendPlatform as y, type PluginClawPart as z };

package/dist/{manifest-types-DQARCQJt.d.ts → manifest-types-CUTNfJTa.d.ts}

@@ -624,4 +624,4 @@ interface ResolvedPluginParts {
  */
 declare function resolvePluginParts(manifest: TegoPluginManifest): ResolvedPluginParts;
 
-export { resolvePluginParts as $, type PluginConfigDeclaration as A, type PluginConfigFieldSchema as B, CLAW_MANIFEST_FILENAME as C, type PluginConfigFieldType as D, EMPTY_CONFIG_SECTION_SUMMARY as E, type PluginConfigSchema as F, type PluginConfigUiHint as G, type PluginFrontendPart as H, type PluginParts as I, type PluginPermissions as J, type PluginPublicFrontendPart as K, type LocalizedText as L, type PluginPublicRouteMethod as M, type PluginSchemaRepair as N, type PluginWorkDelegationDeclaration as O, type PluginPublicRoute as P, type ResolvedClawPart as Q, type ResolvedBackendPart as R, type ResolvedFrontendPart as S, type TegoPluginManifest as T, type ResolvedPluginParts as U, type ResolvedPublicFrontendPart as V, applyConfigDefaults as W, configFieldLabel as X, declaredPartNames as Y, redactSecrets as Z, resolvePluginDeclares as _, type PluginBackendRuntime as a, resolvePluginScope as a0, restoreSecrets as a1, summarizeClawConfig as a2, summarizeConfigDeclaration as a3, type PluginScope as b, type PluginPartName as c, type PluginDeclares as d, type PluginConfigSection as e, type PluginConfigSectionSummary as f, type PluginNavIcon as g, type PluginNavEntry as h, type PluginAgentReadinessDeclaration as i, PLUGIN_BACKEND_PLATFORMS as j, PLUGIN_BACKEND_RUNTIMES as k, PLUGIN_CONFIG_SECRET_SENTINEL as l, PLUGIN_CONFIG_SECTIONS as m, PLUGIN_MANIFEST_FILENAME as n, PLUGIN_NAV_ICONS as o, PLUGIN_NAV_ICON_FALLBACK as p, PLUGIN_PART_DEFAULTS as q, PLUGIN_PART_NAMES as r, type PluginAgentReadinessItem as s, type PluginAgentReadinessResponse as t, type PluginAuditDeclarations as u, type PluginAuditToolDeclaration as v, type PluginBackendLimits as w, type PluginBackendPart as x, type PluginBackendPlatform as y, type PluginClawPart as z };
+export { resolvePluginParts as $, type PluginConfigDeclaration as A, type PluginConfigFieldSchema as B, CLAW_MANIFEST_FILENAME as C, type PluginConfigFieldType as D, EMPTY_CONFIG_SECTION_SUMMARY as E, type PluginConfigSchema as F, type PluginConfigUiHint as G, type PluginFrontendPart as H, type PluginParts as I, type PluginPermissions as J, type PluginPublicFrontendPart as K, type LocalizedText as L, type PluginPublicRouteMethod as M, type PluginSchemaRepair as N, type PluginWorkDelegationDeclaration as O, type PluginNavEntry as P, type ResolvedClawPart as Q, type ResolvedBackendPart as R, type ResolvedFrontendPart as S, type TegoPluginManifest as T, type ResolvedPluginParts as U, type ResolvedPublicFrontendPart as V, applyConfigDefaults as W, configFieldLabel as X, declaredPartNames as Y, redactSecrets as Z, resolvePluginDeclares as _, type PluginPublicRoute as a, resolvePluginScope as a0, restoreSecrets as a1, summarizeClawConfig as a2, summarizeConfigDeclaration as a3, type PluginBackendRuntime as b, type PluginScope as c, type PluginPartName as d, type PluginDeclares as e, type PluginConfigSection as f, type PluginConfigSectionSummary as g, type PluginNavIcon as h, type PluginAgentReadinessDeclaration as i, PLUGIN_BACKEND_PLATFORMS as j, PLUGIN_BACKEND_RUNTIMES as k, PLUGIN_CONFIG_SECRET_SENTINEL as l, PLUGIN_CONFIG_SECTIONS as m, PLUGIN_MANIFEST_FILENAME as n, PLUGIN_NAV_ICONS as o, PLUGIN_NAV_ICON_FALLBACK as p, PLUGIN_PART_DEFAULTS as q, PLUGIN_PART_NAMES as r, type PluginAgentReadinessItem as s, type PluginAgentReadinessResponse as t, type PluginAuditDeclarations as u, type PluginAuditToolDeclaration as v, type PluginBackendLimits as w, type PluginBackendPart as x, type PluginBackendPlatform as y, type PluginClawPart as z };

package/dist/manifest.cjs

@@ -1 +1 @@
-"use strict";var n=Object.defineProperty;var e=(r,t)=>n(r,"name",{value:t,configurable:!0});var chunk3WA3M347_cjs=require("./chunk-3WA3M347.cjs");require("./chunk-ROFUQLOZ.cjs"),require("./chunk-C2OCOPZQ.cjs"),require("./chunk-AJY7ZHXK.cjs"),require("./chunk-OP64Y4IN.cjs"),Object.defineProperty(exports,"PYTHON_LOCK_FILENAME",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.PYTHON_LOCK_FILENAME},"get")}),Object.defineProperty(exports,"PYTHON_RUNNER_VERSION",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.PYTHON_RUNNER_VERSION},"get")}),Object.defineProperty(exports,"PYTHON_WHEELS_DIR",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.PYTHON_WHEELS_DIR},"get")}),Object.defineProperty(exports,"checkPluginAccessCatalog",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.checkPluginAccessCatalog},"get")}),Object.defineProperty(exports,"checkPythonVendoring",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.checkPythonVendoring},"get")}),Object.defineProperty(exports,"normalizePackageName",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.normalizePackageName},"get")}),Object.defineProperty(exports,"parseRequirementsLock",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.parseRequirementsLock},"get")}),Object.defineProperty(exports,"parseTegoPluginManifest",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.parseTegoPluginManifest},"get")}),Object.defineProperty(exports,"parseWheelFilename",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.parseWheelFilename},"get")}),Object.defineProperty(exports,"tegoPluginManifestSchema",{enumerable:!0,get:e(function(){return chunk3WA3M347_cjs.tegoPluginManifestSchema},"get")});
+"use strict";var n=Object.defineProperty;var e=(r,t)=>n(r,"name",{value:t,configurable:!0});var chunkSKNPNPJP_cjs=require("./chunk-SKNPNPJP.cjs"),chunk45Y4CR4R_cjs=require("./chunk-45Y4CR4R.cjs");require("./chunk-2P6UEAPV.cjs"),require("./chunk-N4SXZZPY.cjs"),require("./chunk-6HNG5OZI.cjs"),require("./chunk-AJY7ZHXK.cjs"),require("./chunk-OP64Y4IN.cjs"),Object.defineProperty(exports,"PYTHON_LOCK_FILENAME",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.PYTHON_LOCK_FILENAME},"get")}),Object.defineProperty(exports,"PYTHON_RUNNER_VERSION",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.PYTHON_RUNNER_VERSION},"get")}),Object.defineProperty(exports,"PYTHON_WHEELS_DIR",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.PYTHON_WHEELS_DIR},"get")}),Object.defineProperty(exports,"checkPluginAccessCatalog",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.checkPluginAccessCatalog},"get")}),Object.defineProperty(exports,"checkPythonVendoring",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.checkPythonVendoring},"get")}),Object.defineProperty(exports,"normalizePackageName",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.normalizePackageName},"get")}),Object.defineProperty(exports,"parseRequirementsLock",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.parseRequirementsLock},"get")}),Object.defineProperty(exports,"parseTegoPluginManifest",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.parseTegoPluginManifest},"get")}),Object.defineProperty(exports,"parseWheelFilename",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.parseWheelFilename},"get")}),Object.defineProperty(exports,"tegoPluginManifestSchema",{enumerable:!0,get:e(function(){return chunkSKNPNPJP_cjs.tegoPluginManifestSchema},"get")}),Object.defineProperty(exports,"LOCALE_FILENAME_PATTERN",{enumerable:!0,get:e(function(){return chunk45Y4CR4R_cjs.LOCALE_FILENAME_PATTERN},"get")}),Object.defineProperty(exports,"MIGRATION_FILENAME_PATTERN",{enumerable:!0,get:e(function(){return chunk45Y4CR4R_cjs.MIGRATION_FILENAME_PATTERN},"get")}),Object.defineProperty(exports,"flattenLocaleKeys",{enumerable:!0,get:e(function(){return chunk45Y4CR4R_cjs.flattenLocaleKeys},"get")}),Object.defineProperty(exports,"verifyFrontendLocales",{enumerable:!0,get:e(function(){return chunk45Y4CR4R_cjs.verifyFrontendLocales},"get")}),Object.defineProperty(exports,"verifyMigrationNames",{enumerable:!0,get:e(function(){return chunk45Y4CR4R_cjs.verifyMigrationNames},"get")});

package/dist/manifest.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { T as TegoPluginManifest, y as PluginBackendPlatform } from './manifest-types-DQARCQJt.cjs';
+import { T as TegoPluginManifest, P as PluginNavEntry, y as PluginBackendPlatform } from './manifest-types-CUTNfJTa.cjs';
 import { A as AccessCatalog } from './catalog-CSSbrfEf.cjs';
 
 /**
@@ -22,6 +22,59 @@ type PluginAccessCatalogResult = {
  */
 declare function checkPluginAccessCatalog(manifest: Pick<TegoPluginManifest, 'access' | 'parts'>, raw: unknown): PluginAccessCatalogResult;
 
+/** `zh-CN.json`, `en.json` — the locale file shape the host's loader expects. */
+declare const LOCALE_FILENAME_PATTERN: RegExp;
+/**
+ * `0001_initial.sql`. The numeric prefix is what makes the apply order
+ * deterministic; without it two migrations could be applied in either order,
+ * which is only discovered when a column is missing in production.
+ */
+declare const MIGRATION_FILENAME_PATTERN: RegExp;
+/** Read access to a plugin package or source tree, paths relative to its root with `/`. */
+interface PluginTreeReader {
+    /** Names of the files directly in `dir` (not nested deeper); empty when it does not exist. */
+    list(dir: string): Promise<string[]>;
+    /** The file as UTF-8, or `null` when absent. */
+    readText(path: string): Promise<string | null>;
+}
+/** Every leaf path of a nested translation object, in `a.b.c` form. */
+declare function flattenLocaleKeys(value: unknown, prefix?: string, into?: Set<string>): Set<string>;
+interface LocaleVerification {
+    /** Locale tags found (`zh-CN`, `en`, …), in directory order. */
+    locales: string[];
+    /** Parsed bundles by tag, for checks that need the values. */
+    bundles: Map<string, unknown>;
+    errors: string[];
+}
+/**
+ * Every locale bundle exists, parses, and carries the same keys.
+ *
+ * Three separate failures, all of which used to reach a user as a sidebar row
+ * showing `crm.nav.deals`:
+ *
+ * - a missing language, where the platform is translated and this plugin is
+ *   not. Falling back would hide it permanently, so it is refused where the
+ *   author can act
+ * - a key present in one bundle and absent in another, which is what a
+ *   half-finished translation pass leaves behind
+ * - a nav entry pointing at a key nobody wrote
+ *
+ * Keys are compared against `zh-CN`, the platform's own default, rather than
+ * against a union of all files — a union would let a typo in one file demand
+ * the same typo in the other nine.
+ */
+declare function verifyFrontendLocales(reader: PluginTreeReader, frontend: {
+    i18nDirPath: string;
+    nav: PluginNavEntry[];
+}): Promise<LocaleVerification>;
+interface MigrationVerification {
+    /** Valid migration file names, sorted (= apply order). */
+    migrations: string[];
+    errors: string[];
+}
+/** Migration files are `<ordinal>_<description>.sql` with unique ordinals. */
+declare function verifyMigrationNames(reader: PluginTreeReader, migrationsDirPath: string): Promise<MigrationVerification>;
+
 /**
  * Whether a python backend's vendored wheels will install in the runner.
  *
@@ -2821,4 +2874,4 @@ interface PluginManifestParseResult {
  */
 declare function parseTegoPluginManifest(value: unknown): PluginManifestParseResult;
 
-export { type LockedRequirement, PYTHON_LOCK_FILENAME, PYTHON_RUNNER_VERSION, PYTHON_WHEELS_DIR, type ParsedTegoPluginManifest, type ParsedWheelFilename, type PluginAccessCatalogResult, type PluginManifestParseResult, type VendoredWheel, checkPluginAccessCatalog, checkPythonVendoring, normalizePackageName, parseRequirementsLock, parseTegoPluginManifest, parseWheelFilename, tegoPluginManifestSchema };
+export { LOCALE_FILENAME_PATTERN, type LocaleVerification, type LockedRequirement, MIGRATION_FILENAME_PATTERN, type MigrationVerification, PYTHON_LOCK_FILENAME, PYTHON_RUNNER_VERSION, PYTHON_WHEELS_DIR, type ParsedTegoPluginManifest, type ParsedWheelFilename, type PluginAccessCatalogResult, type PluginManifestParseResult, type PluginTreeReader, type VendoredWheel, checkPluginAccessCatalog, checkPythonVendoring, flattenLocaleKeys, normalizePackageName, parseRequirementsLock, parseTegoPluginManifest, parseWheelFilename, tegoPluginManifestSchema, verifyFrontendLocales, verifyMigrationNames };

package/dist/manifest.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { T as TegoPluginManifest, y as PluginBackendPlatform } from './manifest-types-DQARCQJt.js';
+import { T as TegoPluginManifest, P as PluginNavEntry, y as PluginBackendPlatform } from './manifest-types-CUTNfJTa.js';
 import { A as AccessCatalog } from './catalog-CSSbrfEf.js';
 
 /**
@@ -22,6 +22,59 @@ type PluginAccessCatalogResult = {
  */
 declare function checkPluginAccessCatalog(manifest: Pick<TegoPluginManifest, 'access' | 'parts'>, raw: unknown): PluginAccessCatalogResult;
 
+/** `zh-CN.json`, `en.json` — the locale file shape the host's loader expects. */
+declare const LOCALE_FILENAME_PATTERN: RegExp;
+/**
+ * `0001_initial.sql`. The numeric prefix is what makes the apply order
+ * deterministic; without it two migrations could be applied in either order,
+ * which is only discovered when a column is missing in production.
+ */
+declare const MIGRATION_FILENAME_PATTERN: RegExp;
+/** Read access to a plugin package or source tree, paths relative to its root with `/`. */
+interface PluginTreeReader {
+    /** Names of the files directly in `dir` (not nested deeper); empty when it does not exist. */
+    list(dir: string): Promise<string[]>;
+    /** The file as UTF-8, or `null` when absent. */
+    readText(path: string): Promise<string | null>;
+}
+/** Every leaf path of a nested translation object, in `a.b.c` form. */
+declare function flattenLocaleKeys(value: unknown, prefix?: string, into?: Set<string>): Set<string>;
+interface LocaleVerification {
+    /** Locale tags found (`zh-CN`, `en`, …), in directory order. */
+    locales: string[];
+    /** Parsed bundles by tag, for checks that need the values. */
+    bundles: Map<string, unknown>;
+    errors: string[];
+}
+/**
+ * Every locale bundle exists, parses, and carries the same keys.
+ *
+ * Three separate failures, all of which used to reach a user as a sidebar row
+ * showing `crm.nav.deals`:
+ *
+ * - a missing language, where the platform is translated and this plugin is
+ *   not. Falling back would hide it permanently, so it is refused where the
+ *   author can act
+ * - a key present in one bundle and absent in another, which is what a
+ *   half-finished translation pass leaves behind
+ * - a nav entry pointing at a key nobody wrote
+ *
+ * Keys are compared against `zh-CN`, the platform's own default, rather than
+ * against a union of all files — a union would let a typo in one file demand
+ * the same typo in the other nine.
+ */
+declare function verifyFrontendLocales(reader: PluginTreeReader, frontend: {
+    i18nDirPath: string;
+    nav: PluginNavEntry[];
+}): Promise<LocaleVerification>;
+interface MigrationVerification {
+    /** Valid migration file names, sorted (= apply order). */
+    migrations: string[];
+    errors: string[];
+}
+/** Migration files are `<ordinal>_<description>.sql` with unique ordinals. */
+declare function verifyMigrationNames(reader: PluginTreeReader, migrationsDirPath: string): Promise<MigrationVerification>;
+
 /**
  * Whether a python backend's vendored wheels will install in the runner.
  *
@@ -2821,4 +2874,4 @@ interface PluginManifestParseResult {
  */
 declare function parseTegoPluginManifest(value: unknown): PluginManifestParseResult;
 
-export { type LockedRequirement, PYTHON_LOCK_FILENAME, PYTHON_RUNNER_VERSION, PYTHON_WHEELS_DIR, type ParsedTegoPluginManifest, type ParsedWheelFilename, type PluginAccessCatalogResult, type PluginManifestParseResult, type VendoredWheel, checkPluginAccessCatalog, checkPythonVendoring, normalizePackageName, parseRequirementsLock, parseTegoPluginManifest, parseWheelFilename, tegoPluginManifestSchema };
+export { LOCALE_FILENAME_PATTERN, type LocaleVerification, type LockedRequirement, MIGRATION_FILENAME_PATTERN, type MigrationVerification, PYTHON_LOCK_FILENAME, PYTHON_RUNNER_VERSION, PYTHON_WHEELS_DIR, type ParsedTegoPluginManifest, type ParsedWheelFilename, type PluginAccessCatalogResult, type PluginManifestParseResult, type PluginTreeReader, type VendoredWheel, checkPluginAccessCatalog, checkPythonVendoring, flattenLocaleKeys, normalizePackageName, parseRequirementsLock, parseTegoPluginManifest, parseWheelFilename, tegoPluginManifestSchema, verifyFrontendLocales, verifyMigrationNames };

package/dist/manifest.js

@@ -1 +1 @@
-export{PYTHON_LOCK_FILENAME,PYTHON_RUNNER_VERSION,PYTHON_WHEELS_DIR,checkPluginAccessCatalog,checkPythonVendoring,normalizePackageName,parseRequirementsLock,parseTegoPluginManifest,parseWheelFilename,tegoPluginManifestSchema}from"./chunk-5CU33JVY.js";import"./chunk-BTHXQWHT.js";import"./chunk-7XHF3YSK.js";import"./chunk-VMCGDDGP.js";import"./chunk-SNUCO2MK.js";
+export{PYTHON_LOCK_FILENAME,PYTHON_RUNNER_VERSION,PYTHON_WHEELS_DIR,checkPluginAccessCatalog,checkPythonVendoring,normalizePackageName,parseRequirementsLock,parseTegoPluginManifest,parseWheelFilename,tegoPluginManifestSchema}from"./chunk-EIVA5BR6.js";export{LOCALE_FILENAME_PATTERN,MIGRATION_FILENAME_PATTERN,flattenLocaleKeys,verifyFrontendLocales,verifyMigrationNames}from"./chunk-2NTAWYCG.js";import"./chunk-IVJECPGG.js";import"./chunk-INCA3GFW.js";import"./chunk-56QOZQTY.js";import"./chunk-VMCGDDGP.js";import"./chunk-SNUCO2MK.js";

package/dist/migrations-sync.cjs

@@ -0,0 +1 @@
+"use strict";var f=Object.defineProperty;var o=(e,t)=>f(e,"name",{value:t,configurable:!0});var promises=require("fs/promises"),path=require("path");function parseName(e){const t=/^(\d{4,})_(.+)\.sql$/.exec(e);return t?{ordinal:Number(t[1]),tag:t[2]}:null}o(parseName,"parseName");async function sqlFiles(e){return(await promises.readdir(e).catch(()=>[])).filter(n=>n.endsWith(".sql")).sort()}o(sqlFiles,"sqlFiles");function normalizeGeneratedSql(e){return e.replaceAll('"public".',"")}o(normalizeGeneratedSql,"normalizeGeneratedSql");async function syncMigrations(e){const t=e.generatedDir??"backend/.drizzle",n=e.migrationsDir??"backend/migrations",g=await sqlFiles(path.join(e.root,t)),m=await sqlFiles(path.join(e.root,n)),l=new Map;let s=0;for(const r of m){const a=parseName(r);a&&(l.set(a.tag,r),s=Math.max(s,a.ordinal))}const i={copied:[],problems:[]};for(const r of g){const a=parseName(r);if(!a){i.problems.push(`${t}/${r}: not named <ordinal>_<tag>.sql`);continue}const u=normalizeGeneratedSql(await promises.readFile(path.join(e.root,t,r),"utf8")),d=l.get(a.tag);if(d){await promises.readFile(path.join(e.root,n,d),"utf8")!==u&&i.problems.push(`${n}/${d} differs from the regenerated ${r}. An applied migration is frozen \u2014 add a new one instead of editing it.`);continue}s+=1;const c=`${String(s).padStart(4,"0")}_${a.tag}.sql`;if(e.check){i.problems.push(`${n}/${c} is missing; run \`tego-plugin migrations sync\`.`);continue}await promises.writeFile(path.join(e.root,n,c),u,"utf8"),l.set(a.tag,c),i.copied.push({from:`${t}/${r}`,to:`${n}/${c}`})}return i}o(syncMigrations,"syncMigrations"),exports.normalizeGeneratedSql=normalizeGeneratedSql,exports.syncMigrations=syncMigrations;

package/dist/migrations-sync.d.cts

@@ -0,0 +1,20 @@
+interface MigrationSyncOptions {
+    root: string;
+    /** drizzle-kit's `out`. Default `backend/.drizzle`. */
+    generatedDir?: string;
+    /** The manifest's migrations dir. Default `backend/migrations`. */
+    migrationsDir?: string;
+    /** Verify only (for `build` / CI): report what is missing or edited. */
+    check?: boolean;
+}
+interface MigrationSyncResult {
+    copied: {
+        from: string;
+        to: string;
+    }[];
+    problems: string[];
+}
+declare function normalizeGeneratedSql(sql: string): string;
+declare function syncMigrations(options: MigrationSyncOptions): Promise<MigrationSyncResult>;
+
+export { type MigrationSyncOptions, type MigrationSyncResult, normalizeGeneratedSql, syncMigrations };

package/dist/migrations-sync.d.ts

@@ -0,0 +1,20 @@
+interface MigrationSyncOptions {
+    root: string;
+    /** drizzle-kit's `out`. Default `backend/.drizzle`. */
+    generatedDir?: string;
+    /** The manifest's migrations dir. Default `backend/migrations`. */
+    migrationsDir?: string;
+    /** Verify only (for `build` / CI): report what is missing or edited. */
+    check?: boolean;
+}
+interface MigrationSyncResult {
+    copied: {
+        from: string;
+        to: string;
+    }[];
+    problems: string[];
+}
+declare function normalizeGeneratedSql(sql: string): string;
+declare function syncMigrations(options: MigrationSyncOptions): Promise<MigrationSyncResult>;
+
+export { type MigrationSyncOptions, type MigrationSyncResult, normalizeGeneratedSql, syncMigrations };

package/dist/migrations-sync.js

@@ -0,0 +1 @@
+var w=Object.defineProperty;var o=(t,e)=>w(t,"name",{value:e,configurable:!0});import{readFile as m,writeFile as y,readdir as q}from"fs/promises";import{join as s}from"path";function f(t){const e=/^(\d{4,})_(.+)\.sql$/.exec(t);return e?{ordinal:Number(e[1]),tag:e[2]}:null}o(f,"parseName");async function p(t){return(await q(t).catch(()=>[])).filter(n=>n.endsWith(".sql")).sort()}o(p,"sqlFiles");function $(t){return t.replaceAll('"public".',"")}o($,"normalizeGeneratedSql");async function x(t){const e=t.generatedDir??"backend/.drizzle",n=t.migrationsDir??"backend/migrations",h=await p(s(t.root,e)),b=await p(s(t.root,n)),l=new Map;let c=0;for(const r of b){const a=f(r);a&&(l.set(a.tag,r),c=Math.max(c,a.ordinal))}const i={copied:[],problems:[]};for(const r of h){const a=f(r);if(!a){i.problems.push(`${e}/${r}: not named <ordinal>_<tag>.sql`);continue}const g=$(await m(s(t.root,e,r),"utf8")),u=l.get(a.tag);if(u){await m(s(t.root,n,u),"utf8")!==g&&i.problems.push(`${n}/${u} differs from the regenerated ${r}. An applied migration is frozen \u2014 add a new one instead of editing it.`);continue}c+=1;const d=`${String(c).padStart(4,"0")}_${a.tag}.sql`;if(t.check){i.problems.push(`${n}/${d} is missing; run \`tego-plugin migrations sync\`.`);continue}await y(s(t.root,n,d),g,"utf8"),l.set(a.tag,d),i.copied.push({from:`${e}/${r}`,to:`${n}/${d}`})}return i}o(x,"syncMigrations");export{$ as normalizeGeneratedSql,x as syncMigrations};

package/dist/pack.cjs

@@ -1 +1 @@
-"use strict";var u=Object.defineProperty;var e=(r,n)=>u(r,"name",{value:n,configurable:!0});var chunkTHMWRUAT_cjs=require("./chunk-THMWRUAT.cjs");require("./chunk-W7C357A6.cjs"),require("./chunk-3WA3M347.cjs"),require("./chunk-ROFUQLOZ.cjs"),require("./chunk-C2OCOPZQ.cjs"),require("./chunk-AJY7ZHXK.cjs"),require("./chunk-OP64Y4IN.cjs"),Object.defineProperty(exports,"buildAgentTemplate",{enumerable:!0,get:e(function(){return chunkTHMWRUAT_cjs.buildAgentTemplate},"get")}),Object.defineProperty(exports,"buildPluginBackend",{enumerable:!0,get:e(function(){return chunkTHMWRUAT_cjs.buildPluginBackend},"get")}),Object.defineProperty(exports,"buildPluginTemplates",{enumerable:!0,get:e(function(){return chunkTHMWRUAT_cjs.buildPluginTemplates},"get")}),Object.defineProperty(exports,"lockPlugin",{enumerable:!0,get:e(function(){return chunkTHMWRUAT_cjs.lockPlugin},"get")}),Object.defineProperty(exports,"packPlugin",{enumerable:!0,get:e(function(){return chunkTHMWRUAT_cjs.packPlugin},"get")}),Object.defineProperty(exports,"watchPluginFrontend",{enumerable:!0,get:e(function(){return chunkTHMWRUAT_cjs.watchPluginFrontend},"get")});
+"use strict";var u=Object.defineProperty;var e=(r,n)=>u(r,"name",{value:n,configurable:!0});var chunk4LKRXDYY_cjs=require("./chunk-4LKRXDYY.cjs");require("./chunk-HZ4YWRYX.cjs"),require("./chunk-SKNPNPJP.cjs"),require("./chunk-45Y4CR4R.cjs"),require("./chunk-2P6UEAPV.cjs"),require("./chunk-N4SXZZPY.cjs"),require("./chunk-6HNG5OZI.cjs"),require("./chunk-AJY7ZHXK.cjs"),require("./chunk-OP64Y4IN.cjs"),Object.defineProperty(exports,"buildAgentTemplate",{enumerable:!0,get:e(function(){return chunk4LKRXDYY_cjs.buildAgentTemplate},"get")}),Object.defineProperty(exports,"buildPluginBackend",{enumerable:!0,get:e(function(){return chunk4LKRXDYY_cjs.buildPluginBackend},"get")}),Object.defineProperty(exports,"buildPluginTemplates",{enumerable:!0,get:e(function(){return chunk4LKRXDYY_cjs.buildPluginTemplates},"get")}),Object.defineProperty(exports,"lockPlugin",{enumerable:!0,get:e(function(){return chunk4LKRXDYY_cjs.lockPlugin},"get")}),Object.defineProperty(exports,"packPlugin",{enumerable:!0,get:e(function(){return chunk4LKRXDYY_cjs.packPlugin},"get")}),Object.defineProperty(exports,"readManifest",{enumerable:!0,get:e(function(){return chunk4LKRXDYY_cjs.readManifest},"get")}),Object.defineProperty(exports,"watchPluginFrontend",{enumerable:!0,get:e(function(){return chunk4LKRXDYY_cjs.watchPluginFrontend},"get")});

package/dist/pack.d.cts

@@ -1,4 +1,4 @@
-import { T as TegoPluginManifest, R as ResolvedBackendPart } from './manifest-types-DQARCQJt.cjs';
+import { T as TegoPluginManifest, R as ResolvedBackendPart } from './manifest-types-CUTNfJTa.cjs';
 
 /**
  * Staging a `runtime: "python"` backend: source, locked wheels, and a lock
@@ -85,6 +85,11 @@ interface PackPluginOptions {
     };
     /** Where to report progress. Defaults to `console.log`. Pass `null` to mute. */
     log?: ((message: string) => void) | null;
+    /**
+     * Run `tego-plugin doctor` first (default). Packing stops on the problems
+     * upload would refuse anyway; the rest are summarized, not fatal.
+     */
+    doctor?: boolean;
 }
 interface PackedPlugin {
     /** Absolute path of the archive. */
@@ -144,6 +149,7 @@ interface WatchPluginOptions {
  * Never resolves — the caller is a foreground command the author interrupts.
  */
 declare function watchPluginFrontend(options: WatchPluginOptions): Promise<never>;
+declare function readManifest(root: string): Promise<TegoPluginManifest>;
 interface BuildPluginBackendOptions {
     /** Package root: the directory holding `tego.plugin.json`. */
     root: string;
@@ -166,4 +172,4 @@ interface BuildPluginBackendOptions {
  */
 declare function buildPluginBackend(part: ResolvedBackendPart, options: BuildPluginBackendOptions): Promise<void>;
 
-export { type BuildPluginBackendOptions, type PackPluginOptions, type PackedPlugin, type WatchPluginOptions, buildAgentTemplate, buildPluginBackend, buildPluginTemplates, lockPlugin, packPlugin, watchPluginFrontend };
+export { type BuildPluginBackendOptions, type PackPluginOptions, type PackedPlugin, type WatchPluginOptions, buildAgentTemplate, buildPluginBackend, buildPluginTemplates, lockPlugin, packPlugin, readManifest, watchPluginFrontend };

package/dist/pack.d.ts

@@ -1,4 +1,4 @@
-import { T as TegoPluginManifest, R as ResolvedBackendPart } from './manifest-types-DQARCQJt.js';
+import { T as TegoPluginManifest, R as ResolvedBackendPart } from './manifest-types-CUTNfJTa.js';
 
 /**
  * Staging a `runtime: "python"` backend: source, locked wheels, and a lock
@@ -85,6 +85,11 @@ interface PackPluginOptions {
     };
     /** Where to report progress. Defaults to `console.log`. Pass `null` to mute. */
     log?: ((message: string) => void) | null;
+    /**
+     * Run `tego-plugin doctor` first (default). Packing stops on the problems
+     * upload would refuse anyway; the rest are summarized, not fatal.
+     */
+    doctor?: boolean;
 }
 interface PackedPlugin {
     /** Absolute path of the archive. */
@@ -144,6 +149,7 @@ interface WatchPluginOptions {
  * Never resolves — the caller is a foreground command the author interrupts.
  */
 declare function watchPluginFrontend(options: WatchPluginOptions): Promise<never>;
+declare function readManifest(root: string): Promise<TegoPluginManifest>;
 interface BuildPluginBackendOptions {
     /** Package root: the directory holding `tego.plugin.json`. */
     root: string;
@@ -166,4 +172,4 @@ interface BuildPluginBackendOptions {
  */
 declare function buildPluginBackend(part: ResolvedBackendPart, options: BuildPluginBackendOptions): Promise<void>;
 
-export { type BuildPluginBackendOptions, type PackPluginOptions, type PackedPlugin, type WatchPluginOptions, buildAgentTemplate, buildPluginBackend, buildPluginTemplates, lockPlugin, packPlugin, watchPluginFrontend };
+export { type BuildPluginBackendOptions, type PackPluginOptions, type PackedPlugin, type WatchPluginOptions, buildAgentTemplate, buildPluginBackend, buildPluginTemplates, lockPlugin, packPlugin, readManifest, watchPluginFrontend };

package/dist/pack.js

@@ -1 +1 @@
-export{buildAgentTemplate,buildPluginBackend,buildPluginTemplates,lockPlugin,packPlugin,watchPluginFrontend}from"./chunk-3KUOBGJN.js";import"./chunk-7K37PVGV.js";import"./chunk-5CU33JVY.js";import"./chunk-BTHXQWHT.js";import"./chunk-7XHF3YSK.js";import"./chunk-VMCGDDGP.js";import"./chunk-SNUCO2MK.js";
+export{buildAgentTemplate,buildPluginBackend,buildPluginTemplates,lockPlugin,packPlugin,readManifest,watchPluginFrontend}from"./chunk-FCYAAOHC.js";import"./chunk-I5Z3ECC4.js";import"./chunk-EIVA5BR6.js";import"./chunk-2NTAWYCG.js";import"./chunk-IVJECPGG.js";import"./chunk-INCA3GFW.js";import"./chunk-56QOZQTY.js";import"./chunk-VMCGDDGP.js";import"./chunk-SNUCO2MK.js";

package/dist/publish.cjs

@@ -1 +1 @@
-"use strict";var $=Object.defineProperty;var s=(e,a)=>$(e,"name",{value:a,configurable:!0});var chunkTHMWRUAT_cjs=require("./chunk-THMWRUAT.cjs");require("./chunk-W7C357A6.cjs"),require("./chunk-3WA3M347.cjs");var chunkROFUQLOZ_cjs=require("./chunk-ROFUQLOZ.cjs");require("./chunk-C2OCOPZQ.cjs"),require("./chunk-AJY7ZHXK.cjs"),require("./chunk-OP64Y4IN.cjs");var promises=require("fs/promises"),path=require("path"),API_PREFIX="/api/v1/tego-os";async function publishPlugin(e){const a=e.log===null?()=>{}:e.log??(t=>console.log(t)),n=await chunkTHMWRUAT_cjs.packPlugin({root:e.root,log:a});return publishPackedPlugin(n,e)}s(publishPlugin,"publishPlugin");async function publishPackedPlugin(e,a){const n=a.log===null?()=>{}:a.log??(p=>console.log(p)),t=a.fetchImpl??fetch,r=createCaller(a.server,a.token,t),u=await promises.readFile(e.file),o=path.basename(e.file);n("\u203A presigning upload");const c=await r("POST","/admin/runtime-plugins/presign-stream",{filename:o,mimeType:"application/zip",size:u.byteLength});n(`\u203A uploading ${o} (${u.byteLength} bytes)`),await putArchive(a.server,c.uploadUrl,u,t),n("\u203A inspecting package");const l=await r("POST","/admin/runtime-plugins/inspect",{uploadToken:c.uploadToken});n(`  ${l.pluginId}@${l.semanticVersion} \u2014 ${describeParts(l)}${l.isUpgrade?" (upgrade)":""}${l.requiresConfig?", needs config":""}`),n("\u203A finalizing release");const g=await r("POST","/admin/runtime-plugins/upload",{uploadToken:c.uploadToken,...a.meta});let i=g.release;n(`  release ${i.id} (${i.status})`),(a.approve??!0)&&(n("\u203A approving release"),i=await r("POST",`/admin/runtime-plugins/releases/${encodeURIComponent(i.id)}/approve`,{}),n(`  release ${i.id} (${i.status})`));let d=null;if(a.install??!0){const p=chunkROFUQLOZ_cjs.resolvePluginScope(e.manifest),f=p==="avatar"?{releaseId:i.id,avatarIds:a.avatarIds??[]}:{releaseId:i.id};n(`\u203A installing for tenant (${p}-scoped)`),d=await r("POST","/admin/runtime-plugins/installs",f),reportInstall(d,n)}return{packed:e,preview:l,catalog:g.catalog,release:i,install:d}}s(publishPackedPlugin,"publishPackedPlugin");function describeParts(e){const a=[];return e.parts.frontend&&a.push(`frontend (${e.parts.frontend.locales.length} locales)`),e.parts.backend&&a.push(`backend (${e.parts.backend.migrationCount} migrations)`),e.parts.claw&&a.push("claw"),a.join(", ")||"no parts"}s(describeParts,"describeParts");function reportInstall(e,a){const n=e.avatars;if(!n||n.attempted===0){a(`  installed ${e.pluginId}@${e.version}`);return}const t=n.attempted-n.failures.length;a(`  installed ${e.pluginId}@${e.version} \u2014 ${t}/${n.attempted} avatars`);for(const r of n.failures)a(`    \u2717 ${r.avatarId}: ${r.message}`)}s(reportInstall,"reportInstall");function createCaller(e,a,n){const t=e.replace(/\/+$/,"");return s(async function(u,o,c){const l=await n(`${t}${API_PREFIX}${o}`,{method:u,headers:{authorization:`Bearer ${a}`,...c===void 0?{}:{"content-type":"application/json"}},...c===void 0?{}:{body:JSON.stringify(c)}});return unwrap(l,`${u} ${o}`)},"call")}s(createCaller,"createCaller");async function putArchive(e,a,n,t){const r=e.replace(/\/+$/,""),u=await t(`${r}${a}`,{method:"PUT",headers:{"content-type":"application/zip"},body:n});await unwrap(u,"PUT upload")}s(putArchive,"putArchive");async function unwrap(e,a){let n;try{n=await e.json()}catch{n=null}if(!e.ok||!n?.success){const t=n?.error?.message??`HTTP ${e.status}`;throw new Error(`${a} failed: ${t}`)}return n.data}s(unwrap,"unwrap"),exports.publishPackedPlugin=publishPackedPlugin,exports.publishPlugin=publishPlugin;
+"use strict";var $=Object.defineProperty;var s=(e,a)=>$(e,"name",{value:a,configurable:!0});var chunk4LKRXDYY_cjs=require("./chunk-4LKRXDYY.cjs");require("./chunk-HZ4YWRYX.cjs"),require("./chunk-SKNPNPJP.cjs"),require("./chunk-45Y4CR4R.cjs");var chunk2P6UEAPV_cjs=require("./chunk-2P6UEAPV.cjs");require("./chunk-N4SXZZPY.cjs"),require("./chunk-6HNG5OZI.cjs"),require("./chunk-AJY7ZHXK.cjs"),require("./chunk-OP64Y4IN.cjs");var promises=require("fs/promises"),path=require("path"),API_PREFIX="/api/v1/tego-os";async function publishPlugin(e){const a=e.log===null?()=>{}:e.log??(t=>console.log(t)),n=await chunk4LKRXDYY_cjs.packPlugin({root:e.root,log:a});return publishPackedPlugin(n,e)}s(publishPlugin,"publishPlugin");async function publishPackedPlugin(e,a){const n=a.log===null?()=>{}:a.log??(p=>console.log(p)),t=a.fetchImpl??fetch,r=createCaller(a.server,a.token,t),u=await promises.readFile(e.file),o=path.basename(e.file);n("\u203A presigning upload");const l=await r("POST","/admin/runtime-plugins/presign-stream",{filename:o,mimeType:"application/zip",size:u.byteLength});n(`\u203A uploading ${o} (${u.byteLength} bytes)`),await putArchive(a.server,l.uploadUrl,u,t),n("\u203A inspecting package");const c=await r("POST","/admin/runtime-plugins/inspect",{uploadToken:l.uploadToken});n(`  ${c.pluginId}@${c.semanticVersion} \u2014 ${describeParts(c)}${c.isUpgrade?" (upgrade)":""}${c.requiresConfig?", needs config":""}`),n("\u203A finalizing release");const g=await r("POST","/admin/runtime-plugins/upload",{uploadToken:l.uploadToken,...a.meta});let i=g.release;n(`  release ${i.id} (${i.status})`),(a.approve??!0)&&(n("\u203A approving release"),i=await r("POST",`/admin/runtime-plugins/releases/${encodeURIComponent(i.id)}/approve`,{}),n(`  release ${i.id} (${i.status})`));let d=null;if(a.install??!0){const p=chunk2P6UEAPV_cjs.resolvePluginScope(e.manifest),f=p==="avatar"?{releaseId:i.id,avatarIds:a.avatarIds??[]}:{releaseId:i.id};n(`\u203A installing for tenant (${p}-scoped)`),d=await r("POST","/admin/runtime-plugins/installs",f),reportInstall(d,n)}return{packed:e,preview:c,catalog:g.catalog,release:i,install:d}}s(publishPackedPlugin,"publishPackedPlugin");function describeParts(e){const a=[];return e.parts.frontend&&a.push(`frontend (${e.parts.frontend.locales.length} locales)`),e.parts.backend&&a.push(`backend (${e.parts.backend.migrationCount} migrations)`),e.parts.claw&&a.push("claw"),a.join(", ")||"no parts"}s(describeParts,"describeParts");function reportInstall(e,a){const n=e.avatars;if(!n||n.attempted===0){a(`  installed ${e.pluginId}@${e.version}`);return}const t=n.attempted-n.failures.length;a(`  installed ${e.pluginId}@${e.version} \u2014 ${t}/${n.attempted} avatars`);for(const r of n.failures)a(`    \u2717 ${r.avatarId}: ${r.message}`)}s(reportInstall,"reportInstall");function createCaller(e,a,n){const t=e.replace(/\/+$/,"");return s(async function(u,o,l){const c=await n(`${t}${API_PREFIX}${o}`,{method:u,headers:{authorization:`Bearer ${a}`,...l===void 0?{}:{"content-type":"application/json"}},...l===void 0?{}:{body:JSON.stringify(l)}});return unwrap(c,`${u} ${o}`)},"call")}s(createCaller,"createCaller");async function putArchive(e,a,n,t){const r=e.replace(/\/+$/,""),u=await t(`${r}${a}`,{method:"PUT",headers:{"content-type":"application/zip"},body:n});await unwrap(u,"PUT upload")}s(putArchive,"putArchive");async function unwrap(e,a){let n;try{n=await e.json()}catch{n=null}if(!e.ok||!n?.success){const t=n?.error?.message??`HTTP ${e.status}`;throw new Error(`${a} failed: ${t}`)}return n.data}s(unwrap,"unwrap"),exports.publishPackedPlugin=publishPackedPlugin,exports.publishPlugin=publishPlugin;

package/dist/publish.d.cts

@@ -1,5 +1,5 @@
 import { PackedPlugin } from './pack.cjs';
-import './manifest-types-DQARCQJt.cjs';
+import './manifest-types-CUTNfJTa.cjs';
 
 interface PublishPluginOptions {
     /** Package root: the directory holding `tego.plugin.json`. */

package/dist/publish.d.ts

@@ -1,5 +1,5 @@
 import { PackedPlugin } from './pack.js';
-import './manifest-types-DQARCQJt.js';
+import './manifest-types-CUTNfJTa.js';
 
 interface PublishPluginOptions {
     /** Package root: the directory holding `tego.plugin.json`. */

package/dist/publish.js

@@ -1 +1 @@
-var h=Object.defineProperty;var o=(e,a)=>h(e,"name",{value:a,configurable:!0});import{packPlugin as v}from"./chunk-3KUOBGJN.js";import"./chunk-7K37PVGV.js";import"./chunk-5CU33JVY.js";import{resolvePluginScope as P}from"./chunk-BTHXQWHT.js";import"./chunk-7XHF3YSK.js";import"./chunk-VMCGDDGP.js";import"./chunk-SNUCO2MK.js";import{readFile as w}from"fs/promises";import{basename as y}from"path";var I="/api/v1/tego-os";async function T(e){const a=e.log===null?()=>{}:e.log??(n=>console.log(n)),t=await v({root:e.root,log:a});return f(t,e)}o(T,"publishPlugin");async function f(e,a){const t=a.log===null?()=>{}:a.log??(p=>console.log(p)),n=a.fetchImpl??fetch,r=A(a.server,a.token,n),s=await w(e.file),c=y(e.file);t("\u203A presigning upload");const u=await r("POST","/admin/runtime-plugins/presign-stream",{filename:c,mimeType:"application/zip",size:s.byteLength});t(`\u203A uploading ${c} (${s.byteLength} bytes)`),await S(a.server,u.uploadUrl,s,n),t("\u203A inspecting package");const l=await r("POST","/admin/runtime-plugins/inspect",{uploadToken:u.uploadToken});t(`  ${l.pluginId}@${l.semanticVersion} \u2014 ${b(l)}${l.isUpgrade?" (upgrade)":""}${l.requiresConfig?", needs config":""}`),t("\u203A finalizing release");const g=await r("POST","/admin/runtime-plugins/upload",{uploadToken:u.uploadToken,...a.meta});let i=g.release;t(`  release ${i.id} (${i.status})`),(a.approve??!0)&&(t("\u203A approving release"),i=await r("POST",`/admin/runtime-plugins/releases/${encodeURIComponent(i.id)}/approve`,{}),t(`  release ${i.id} (${i.status})`));let d=null;if(a.install??!0){const p=P(e.manifest),$=p==="avatar"?{releaseId:i.id,avatarIds:a.avatarIds??[]}:{releaseId:i.id};t(`\u203A installing for tenant (${p}-scoped)`),d=await r("POST","/admin/runtime-plugins/installs",$),k(d,t)}return{packed:e,preview:l,catalog:g.catalog,release:i,install:d}}o(f,"publishPackedPlugin");function b(e){const a=[];return e.parts.frontend&&a.push(`frontend (${e.parts.frontend.locales.length} locales)`),e.parts.backend&&a.push(`backend (${e.parts.backend.migrationCount} migrations)`),e.parts.claw&&a.push("claw"),a.join(", ")||"no parts"}o(b,"describeParts");function k(e,a){const t=e.avatars;if(!t||t.attempted===0){a(`  installed ${e.pluginId}@${e.version}`);return}const n=t.attempted-t.failures.length;a(`  installed ${e.pluginId}@${e.version} \u2014 ${n}/${t.attempted} avatars`);for(const r of t.failures)a(`    \u2717 ${r.avatarId}: ${r.message}`)}o(k,"reportInstall");function A(e,a,t){const n=e.replace(/\/+$/,"");return o(async function(s,c,u){const l=await t(`${n}${I}${c}`,{method:s,headers:{authorization:`Bearer ${a}`,...u===void 0?{}:{"content-type":"application/json"}},...u===void 0?{}:{body:JSON.stringify(u)}});return m(l,`${s} ${c}`)},"call")}o(A,"createCaller");async function S(e,a,t,n){const r=e.replace(/\/+$/,""),s=await n(`${r}${a}`,{method:"PUT",headers:{"content-type":"application/zip"},body:t});await m(s,"PUT upload")}o(S,"putArchive");async function m(e,a){let t;try{t=await e.json()}catch{t=null}if(!e.ok||!t?.success){const n=t?.error?.message??`HTTP ${e.status}`;throw new Error(`${a} failed: ${n}`)}return t.data}o(m,"unwrap");export{f as publishPackedPlugin,T as publishPlugin};
+var h=Object.defineProperty;var o=(e,a)=>h(e,"name",{value:a,configurable:!0});import{packPlugin as v}from"./chunk-FCYAAOHC.js";import"./chunk-I5Z3ECC4.js";import"./chunk-EIVA5BR6.js";import"./chunk-2NTAWYCG.js";import{resolvePluginScope as P}from"./chunk-IVJECPGG.js";import"./chunk-INCA3GFW.js";import"./chunk-56QOZQTY.js";import"./chunk-VMCGDDGP.js";import"./chunk-SNUCO2MK.js";import{readFile as w}from"fs/promises";import{basename as y}from"path";var I="/api/v1/tego-os";async function T(e){const a=e.log===null?()=>{}:e.log??(n=>console.log(n)),t=await v({root:e.root,log:a});return m(t,e)}o(T,"publishPlugin");async function m(e,a){const t=a.log===null?()=>{}:a.log??(p=>console.log(p)),n=a.fetchImpl??fetch,r=A(a.server,a.token,n),s=await w(e.file),c=y(e.file);t("\u203A presigning upload");const u=await r("POST","/admin/runtime-plugins/presign-stream",{filename:c,mimeType:"application/zip",size:s.byteLength});t(`\u203A uploading ${c} (${s.byteLength} bytes)`),await S(a.server,u.uploadUrl,s,n),t("\u203A inspecting package");const l=await r("POST","/admin/runtime-plugins/inspect",{uploadToken:u.uploadToken});t(`  ${l.pluginId}@${l.semanticVersion} \u2014 ${b(l)}${l.isUpgrade?" (upgrade)":""}${l.requiresConfig?", needs config":""}`),t("\u203A finalizing release");const g=await r("POST","/admin/runtime-plugins/upload",{uploadToken:u.uploadToken,...a.meta});let i=g.release;t(`  release ${i.id} (${i.status})`),(a.approve??!0)&&(t("\u203A approving release"),i=await r("POST",`/admin/runtime-plugins/releases/${encodeURIComponent(i.id)}/approve`,{}),t(`  release ${i.id} (${i.status})`));let d=null;if(a.install??!0){const p=P(e.manifest),$=p==="avatar"?{releaseId:i.id,avatarIds:a.avatarIds??[]}:{releaseId:i.id};t(`\u203A installing for tenant (${p}-scoped)`),d=await r("POST","/admin/runtime-plugins/installs",$),k(d,t)}return{packed:e,preview:l,catalog:g.catalog,release:i,install:d}}o(m,"publishPackedPlugin");function b(e){const a=[];return e.parts.frontend&&a.push(`frontend (${e.parts.frontend.locales.length} locales)`),e.parts.backend&&a.push(`backend (${e.parts.backend.migrationCount} migrations)`),e.parts.claw&&a.push("claw"),a.join(", ")||"no parts"}o(b,"describeParts");function k(e,a){const t=e.avatars;if(!t||t.attempted===0){a(`  installed ${e.pluginId}@${e.version}`);return}const n=t.attempted-t.failures.length;a(`  installed ${e.pluginId}@${e.version} \u2014 ${n}/${t.attempted} avatars`);for(const r of t.failures)a(`    \u2717 ${r.avatarId}: ${r.message}`)}o(k,"reportInstall");function A(e,a,t){const n=e.replace(/\/+$/,"");return o(async function(s,c,u){const l=await t(`${n}${I}${c}`,{method:s,headers:{authorization:`Bearer ${a}`,...u===void 0?{}:{"content-type":"application/json"}},...u===void 0?{}:{body:JSON.stringify(u)}});return f(l,`${s} ${c}`)},"call")}o(A,"createCaller");async function S(e,a,t,n){const r=e.replace(/\/+$/,""),s=await n(`${r}${a}`,{method:"PUT",headers:{"content-type":"application/zip"},body:t});await f(s,"PUT upload")}o(S,"putArchive");async function f(e,a){let t;try{t=await e.json()}catch{t=null}if(!e.ok||!t?.success){const n=t?.error?.message??`HTTP ${e.status}`;throw new Error(`${a} failed: ${n}`)}return t.data}o(f,"unwrap");export{m as publishPackedPlugin,T as publishPlugin};

package/dist/react.cjs

@@ -0,0 +1 @@
+"use strict";var p=Object.defineProperty;var n=(e,t)=>p(e,"name",{value:t,configurable:!0});var react=require("react"),PluginApiError=class extends Error{static{n(this,"PluginApiError")}constructor(e,t,r,s={}){super(e),this.status=t,this.code=r,this.detail=s,this.name="PluginApiError"}status;code;detail};function toPluginApiError(e,t){const r=t&&typeof t=="object"?t.error:void 0;if(typeof r=="string")return new PluginApiError(r,e,void 0);if(r&&typeof r=="object"){const{code:s,message:i,detail:o}=r;return new PluginApiError(typeof i=="string"?i:`HTTP ${e}`,e,typeof s=="string"?s:void 0,o&&typeof o=="object"?o:{})}return new PluginApiError(`HTTP ${e}`,e,void 0)}n(toPluginApiError,"toPluginApiError");function createApiClient(e){const t=n(async(r,s,i)=>{const o=await e.request(s,i===void 0?{method:r}:{method:r,headers:{"content-type":"application/json"},body:JSON.stringify(i)}),u=await o.text();let c=null;try{c=u?JSON.parse(u):null}catch{c=u||null}if(!o.ok)throw toPluginApiError(o.status,c);return c},"send");return{get:n(r=>t("GET",r),"get"),post:n((r,s)=>t("POST",r,s??{}),"post"),put:n((r,s)=>t("PUT",r,s),"put"),patch:n((r,s)=>t("PATCH",r,s),"patch"),delete:n(r=>t("DELETE",r),"delete")}}n(createApiClient,"createApiClient");function withQuery(e,t){const r=new URLSearchParams;for(const[i,o]of Object.entries(t))o!==void 0&&o!==""&&r.set(i,String(o));const s=r.toString();return s?`${e}?${s}`:e}n(withQuery,"withQuery");function describeApiError(e,t){return e instanceof PluginApiError?e.code?{key:`${t}.errors.${e.code}`,message:e.message}:{message:e.message}:{message:e instanceof Error?e.message:String(e)}}n(describeApiError,"describeApiError");var HostContext=react.createContext(null);function HostProvider({value:e,children:t}){return react.createElement(HostContext.Provider,{value:e},t)}n(HostProvider,"HostProvider");function useHost(){const e=react.useContext(HostContext);if(!e)throw new Error("useHost() outside <HostProvider>");return e}n(useHost,"useHost");function usePluginRoute(){const{route:e}=useHost();return react.useSyncExternalStore(t=>e.subscribe(t),()=>e.current())}n(usePluginRoute,"usePluginRoute");function useLiveUpdates(e,t={}){const{events:r}=useHost(),s=react.useRef({onChange:e,filter:t.filter});s.current={onChange:e,filter:t.filter};const i=t.waitMs??400;react.useEffect(()=>{let o=[],u;const c=r.subscribe(a=>{s.current.filter&&!s.current.filter(a)||(o.push(a),!u&&(u=setTimeout(()=>{u=void 0;const l=o;o=[],s.current.onChange(l)},i)))});return()=>{c(),u&&clearTimeout(u)}},[r,i])}n(useLiveUpdates,"useLiveUpdates");var PluginErrorBoundary=class extends react.Component{static{n(this,"PluginErrorBoundary")}state={error:null};static getDerivedStateFromError(e){return{error:e instanceof Error?e:new Error(String(e))}}componentDidCatch(e,t){this.props.onError?.(e,t)}reset=n(()=>this.setState({error:null}),"reset");render(){return this.state.error?this.props.fallback(this.state.error,this.reset):this.props.children??null}};exports.HostProvider=HostProvider,exports.PluginApiError=PluginApiError,exports.PluginErrorBoundary=PluginErrorBoundary,exports.createApiClient=createApiClient,exports.describeApiError=describeApiError,exports.toPluginApiError=toPluginApiError,exports.useHost=useHost,exports.useLiveUpdates=useLiveUpdates,exports.usePluginRoute=usePluginRoute,exports.withQuery=withQuery;

package/dist/react.d.cts

@@ -0,0 +1,101 @@
+import * as react from 'react';
+import { ReactNode, Component, ErrorInfo } from 'react';
+import { PluginApiClient, PluginHostContext, PluginEvent, PluginRoute } from './frontend.cjs';
+
+/**
+ * Calls to the plugin's own backend through `ctx.api`, with errors that keep
+ * what the backend said.
+ *
+ * `ctx.api.json` throws a bare `Error('<method> <path>: <status>')` and drops
+ * the body, so a screen cannot tell "that note is locked" from "the server
+ * fell over". This keeps the code for translation and the message for the
+ * fallback. Two shapes arrive here: the plugin backend's
+ * `{ error: { code, message, detail? } }` (what `pluginErrorHandler` writes)
+ * and the gateway's `{ success: false, error: string | { message } }`.
+ */
+
+declare class PluginApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly detail: Record<string, unknown>;
+    constructor(message: string, status: number, code: string | undefined, detail?: Record<string, unknown>);
+}
+/** The error a failed response carries, whichever side wrote it. */
+declare function toPluginApiError(status: number, body: unknown): PluginApiError;
+interface PluginApi {
+    get<T>(path: string): Promise<T>;
+    /** A POST without a body still sends `{}`: validators read JSON on every write. */
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}
+declare function createApiClient(client: PluginApiClient): PluginApi;
+/** `path?a=1&b=x`, leaving out empty values. */
+declare function withQuery(path: string, params: Record<string, string | number | undefined>): string;
+/**
+ * What to tell the user about a failed call: the translation key
+ * `<namespace>.errors.<code>` when the backend sent a code, and the backend's
+ * own sentence as the fallback.
+ *
+ * ```ts
+ * const { key, message } = describeApiError(error, 'notes');
+ * return key ? t(key, { defaultValue: message }) : message;
+ * ```
+ */
+declare function describeApiError(error: unknown, namespace: string): {
+    key?: string;
+    message: string;
+};
+
+/** Makes `ctx` available to `useHost` / `usePluginRoute` below it. */
+declare function HostProvider({ value, children, }: {
+    value: PluginHostContext;
+    children?: ReactNode;
+}): react.FunctionComponentElement<react.ProviderProps<PluginHostContext | null>>;
+declare function useHost(): PluginHostContext;
+/**
+ * The in-plugin route, re-rendering on every host navigation.
+ *
+ * The shell does not remount the page when only the path below `/p/<id>`
+ * changes, so reading `ctx.route.current()` once is a stale page.
+ */
+declare function usePluginRoute(): PluginRoute;
+/**
+ * Calls `onChange` when the plugin's backend publishes events, at most once
+ * per `waitMs` (a burst of writes is one refresh). Pass a stable callback,
+ * e.g. `() => queryClient.invalidateQueries({ queryKey: ['notes'] })`.
+ *
+ * `filter` limits it to some event names. The stream may be down: keep a slow
+ * `refetchInterval` as a fallback (faster while `ctx.events.connected()` is false).
+ */
+declare function useLiveUpdates(onChange: (events: PluginEvent[]) => void, options?: {
+    waitMs?: number;
+    filter?: (event: PluginEvent) => boolean;
+}): void;
+interface BoundaryProps {
+    /** What to show instead of the crashed tree; `reset` renders the children again. */
+    fallback: (error: Error, reset: () => void) => ReactNode;
+    onError?(error: Error, info: ErrorInfo): void;
+    children?: ReactNode;
+}
+/**
+ * The plugin's own error boundary. The shell's boundary sits outside this
+ * React root and never sees an error thrown inside it: without one a render
+ * error is a blank page that reads as the platform losing the plugin.
+ */
+declare class PluginErrorBoundary extends Component<BoundaryProps, {
+    error: Error | null;
+}> {
+    state: {
+        error: Error | null;
+    };
+    static getDerivedStateFromError(error: unknown): {
+        error: Error;
+    };
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    private readonly reset;
+    render(): ReactNode;
+}
+
+export { HostProvider, type PluginApi, PluginApiError, PluginErrorBoundary, createApiClient, describeApiError, toPluginApiError, useHost, useLiveUpdates, usePluginRoute, withQuery };

package/dist/react.d.ts

@@ -0,0 +1,101 @@
+import * as react from 'react';
+import { ReactNode, Component, ErrorInfo } from 'react';
+import { PluginApiClient, PluginHostContext, PluginEvent, PluginRoute } from './frontend.js';
+
+/**
+ * Calls to the plugin's own backend through `ctx.api`, with errors that keep
+ * what the backend said.
+ *
+ * `ctx.api.json` throws a bare `Error('<method> <path>: <status>')` and drops
+ * the body, so a screen cannot tell "that note is locked" from "the server
+ * fell over". This keeps the code for translation and the message for the
+ * fallback. Two shapes arrive here: the plugin backend's
+ * `{ error: { code, message, detail? } }` (what `pluginErrorHandler` writes)
+ * and the gateway's `{ success: false, error: string | { message } }`.
+ */
+
+declare class PluginApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly detail: Record<string, unknown>;
+    constructor(message: string, status: number, code: string | undefined, detail?: Record<string, unknown>);
+}
+/** The error a failed response carries, whichever side wrote it. */
+declare function toPluginApiError(status: number, body: unknown): PluginApiError;
+interface PluginApi {
+    get<T>(path: string): Promise<T>;
+    /** A POST without a body still sends `{}`: validators read JSON on every write. */
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body: unknown): Promise<T>;
+    patch<T>(path: string, body: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+}
+declare function createApiClient(client: PluginApiClient): PluginApi;
+/** `path?a=1&b=x`, leaving out empty values. */
+declare function withQuery(path: string, params: Record<string, string | number | undefined>): string;
+/**
+ * What to tell the user about a failed call: the translation key
+ * `<namespace>.errors.<code>` when the backend sent a code, and the backend's
+ * own sentence as the fallback.
+ *
+ * ```ts
+ * const { key, message } = describeApiError(error, 'notes');
+ * return key ? t(key, { defaultValue: message }) : message;
+ * ```
+ */
+declare function describeApiError(error: unknown, namespace: string): {
+    key?: string;
+    message: string;
+};
+
+/** Makes `ctx` available to `useHost` / `usePluginRoute` below it. */
+declare function HostProvider({ value, children, }: {
+    value: PluginHostContext;
+    children?: ReactNode;
+}): react.FunctionComponentElement<react.ProviderProps<PluginHostContext | null>>;
+declare function useHost(): PluginHostContext;
+/**
+ * The in-plugin route, re-rendering on every host navigation.
+ *
+ * The shell does not remount the page when only the path below `/p/<id>`
+ * changes, so reading `ctx.route.current()` once is a stale page.
+ */
+declare function usePluginRoute(): PluginRoute;
+/**
+ * Calls `onChange` when the plugin's backend publishes events, at most once
+ * per `waitMs` (a burst of writes is one refresh). Pass a stable callback,
+ * e.g. `() => queryClient.invalidateQueries({ queryKey: ['notes'] })`.
+ *
+ * `filter` limits it to some event names. The stream may be down: keep a slow
+ * `refetchInterval` as a fallback (faster while `ctx.events.connected()` is false).
+ */
+declare function useLiveUpdates(onChange: (events: PluginEvent[]) => void, options?: {
+    waitMs?: number;
+    filter?: (event: PluginEvent) => boolean;
+}): void;
+interface BoundaryProps {
+    /** What to show instead of the crashed tree; `reset` renders the children again. */
+    fallback: (error: Error, reset: () => void) => ReactNode;
+    onError?(error: Error, info: ErrorInfo): void;
+    children?: ReactNode;
+}
+/**
+ * The plugin's own error boundary. The shell's boundary sits outside this
+ * React root and never sees an error thrown inside it: without one a render
+ * error is a blank page that reads as the platform losing the plugin.
+ */
+declare class PluginErrorBoundary extends Component<BoundaryProps, {
+    error: Error | null;
+}> {
+    state: {
+        error: Error | null;
+    };
+    static getDerivedStateFromError(error: unknown): {
+        error: Error;
+    };
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    private readonly reset;
+    render(): ReactNode;
+}
+
+export { HostProvider, type PluginApi, PluginApiError, PluginErrorBoundary, createApiClient, describeApiError, toPluginApiError, useHost, useLiveUpdates, usePluginRoute, withQuery };

package/dist/react.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var s=(e,t)=>h(e,"name",{value:t,configurable:!0});import{createContext as E,createElement as m,useContext as v,useSyncExternalStore as P,useRef as w,useEffect as y,Component as S}from"react";var a=class extends Error{static{s(this,"PluginApiError")}constructor(e,t,r,n={}){super(e),this.status=t,this.code=r,this.detail=n,this.name="PluginApiError"}status;code;detail};function d(e,t){const r=t&&typeof t=="object"?t.error:void 0;if(typeof r=="string")return new a(r,e,void 0);if(r&&typeof r=="object"){const{code:n,message:i,detail:o}=r;return new a(typeof i=="string"?i:`HTTP ${e}`,e,typeof n=="string"?n:void 0,o&&typeof o=="object"?o:{})}return new a(`HTTP ${e}`,e,void 0)}s(d,"toPluginApiError");function b(e){const t=s(async(r,n,i)=>{const o=await e.request(n,i===void 0?{method:r}:{method:r,headers:{"content-type":"application/json"},body:JSON.stringify(i)}),c=await o.text();let u=null;try{u=c?JSON.parse(c):null}catch{u=c||null}if(!o.ok)throw d(o.status,u);return u},"send");return{get:s(r=>t("GET",r),"get"),post:s((r,n)=>t("POST",r,n??{}),"post"),put:s((r,n)=>t("PUT",r,n),"put"),patch:s((r,n)=>t("PATCH",r,n),"patch"),delete:s(r=>t("DELETE",r),"delete")}}s(b,"createApiClient");function T(e,t){const r=new URLSearchParams;for(const[i,o]of Object.entries(t))o!==void 0&&o!==""&&r.set(i,String(o));const n=r.toString();return n?`${e}?${n}`:e}s(T,"withQuery");function x(e,t){return e instanceof a?e.code?{key:`${t}.errors.${e.code}`,message:e.message}:{message:e.message}:{message:e instanceof Error?e.message:String(e)}}s(x,"describeApiError");var p=E(null);function H({value:e,children:t}){return m(p.Provider,{value:e},t)}s(H,"HostProvider");function l(){const e=v(p);if(!e)throw new Error("useHost() outside <HostProvider>");return e}s(l,"useHost");function C(){const{route:e}=l();return P(t=>e.subscribe(t),()=>e.current())}s(C,"usePluginRoute");function A(e,t={}){const{events:r}=l(),n=w({onChange:e,filter:t.filter});n.current={onChange:e,filter:t.filter};const i=t.waitMs??400;y(()=>{let o=[],c;const u=r.subscribe(f=>{n.current.filter&&!n.current.filter(f)||(o.push(f),!c&&(c=setTimeout(()=>{c=void 0;const g=o;o=[],n.current.onChange(g)},i)))});return()=>{u(),c&&clearTimeout(c)}},[r,i])}s(A,"useLiveUpdates");var $=class extends S{static{s(this,"PluginErrorBoundary")}state={error:null};static getDerivedStateFromError(e){return{error:e instanceof Error?e:new Error(String(e))}}componentDidCatch(e,t){this.props.onError?.(e,t)}reset=s(()=>this.setState({error:null}),"reset");render(){return this.state.error?this.props.fallback(this.state.error,this.reset):this.props.children??null}};export{H as HostProvider,a as PluginApiError,$ as PluginErrorBoundary,b as createApiClient,x as describeApiError,d as toPluginApiError,l as useHost,A as useLiveUpdates,C as usePluginRoute,T as withQuery};