@powerhousedao/shared 6.2.3-dev.85 → 6.2.3-dev.87

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/dist/clis/args/{help-CmnOv3z3.d.mts → help-Cgh3krcq.d.mts} +14 -2
  2. package/dist/clis/args/help-Cgh3krcq.d.mts.map +1 -0
  3. package/dist/clis/args/{help-Cb66IK-J.mjs → help-DnOa5Gr-.mjs} +9 -1
  4. package/dist/clis/args/help-DnOa5Gr-.mjs.map +1 -0
  5. package/dist/clis/args/help.d.mts +1 -1
  6. package/dist/clis/args/help.mjs +2 -1
  7. package/dist/clis/args/index.d.mts +3 -2
  8. package/dist/clis/args/index.mjs +3 -2
  9. package/dist/clis/args/keyframes.d.mts +25 -0
  10. package/dist/clis/args/keyframes.d.mts.map +1 -0
  11. package/dist/clis/args/keyframes.mjs +42 -0
  12. package/dist/clis/args/keyframes.mjs.map +1 -0
  13. package/dist/clis/build-pieces.d.mts +1 -1
  14. package/dist/clis/command-names.d.mts +1 -1
  15. package/dist/clis/command-names.d.mts.map +1 -1
  16. package/dist/clis/command-names.mjs +1 -0
  17. package/dist/clis/command-names.mjs.map +1 -1
  18. package/dist/clis/constants.d.mts +1 -1
  19. package/dist/clis/index.d.mts +126 -3
  20. package/dist/clis/index.d.mts.map +1 -1
  21. package/dist/clis/index.mjs +92 -3
  22. package/dist/clis/index.mjs.map +1 -1
  23. package/dist/clis/{types-0G3o7wZE.d.mts → types-ByIjNbGg.d.mts} +45 -2
  24. package/dist/clis/{types-0G3o7wZE.d.mts.map → types-ByIjNbGg.d.mts.map} +1 -1
  25. package/dist/connect/config-loader.d.ts +1 -1
  26. package/dist/connect/connect-config-schema.d.ts +2 -2
  27. package/dist/connect/connect-config-schema.js +16 -3
  28. package/dist/connect/connect-config-schema.js.map +1 -1
  29. package/dist/connect/index.d.ts +3 -3
  30. package/dist/connect/index.js +2 -2
  31. package/dist/{connect-config-schema-c39dvEne.d.ts → connect-config-schema-LzQbfZHm.d.ts} +37 -3
  32. package/dist/{connect-config-schema-c39dvEne.d.ts.map → connect-config-schema-LzQbfZHm.d.ts.map} +1 -1
  33. package/dist/document-drive/index.d.ts +3 -3
  34. package/dist/document-drive/index.js +1 -1
  35. package/dist/document-model/dispatch.d.ts +1 -1
  36. package/dist/document-model/errors.d.ts +2 -2
  37. package/dist/document-model/errors.js +49 -1
  38. package/dist/document-model/errors.js.map +1 -1
  39. package/dist/document-model/index.d.ts +2 -3
  40. package/dist/document-model/index.js +5 -5
  41. package/dist/document-model/utils.d.ts +2 -2
  42. package/dist/document-model/utils.js +2 -2
  43. package/dist/{document-model-CMyP_XZ8.js → document-model-B98EymhI.js} +927 -402
  44. package/dist/document-model-B98EymhI.js.map +1 -0
  45. package/dist/{index-CR7EJfyR.d.ts → index-59YGevDz.d.ts} +2 -2
  46. package/dist/{index-CR7EJfyR.d.ts.map → index-59YGevDz.d.ts.map} +1 -1
  47. package/dist/index.d.ts +4 -4
  48. package/dist/processors/index.d.ts +2 -2
  49. package/dist/processors/index.js +1 -1
  50. package/dist/processors/testing.d.ts +1 -1
  51. package/dist/{purge-YMJM0Vl7.js → purge-BOqSpe4O.js} +224 -6
  52. package/dist/purge-BOqSpe4O.js.map +1 -0
  53. package/dist/registry/index.d.ts +2 -2
  54. package/dist/registry/manifest-slim.d.ts +2 -2
  55. package/dist/{types-DR4mZKAj.d.ts → types-D1ToC1mB.d.ts} +651 -126
  56. package/dist/types-D1ToC1mB.d.ts.map +1 -0
  57. package/dist/{types-DPBZvxkk.d.ts → types-DRj0sF2w.d.ts} +2 -2
  58. package/dist/{types-DPBZvxkk.d.ts.map → types-DRj0sF2w.d.ts.map} +1 -1
  59. package/dist/{utils-CSF716ux.js → utils-DiV32YIj.js} +45 -2
  60. package/dist/utils-DiV32YIj.js.map +1 -0
  61. package/package.json +1 -1
  62. package/dist/clis/args/help-Cb66IK-J.mjs.map +0 -1
  63. package/dist/clis/args/help-CmnOv3z3.d.mts.map +0 -1
  64. package/dist/document-model-CMyP_XZ8.js.map +0 -1
  65. package/dist/purge-YMJM0Vl7.js.map +0 -1
  66. package/dist/types-DR4mZKAj.d.ts.map +0 -1
  67. package/dist/utils-BrKxCmKx.d.ts +0 -18
  68. package/dist/utils-BrKxCmKx.d.ts.map +0 -1
  69. package/dist/utils-CSF716ux.js.map +0 -1
@@ -1048,6 +1048,43 @@ const installArgs = {
1048
1048
  ...debugArgs
1049
1049
  };
1050
1050
  //#endregion
1051
+ //#region clis/args/keyframes.ts
1052
+ const KEYFRAMES_ACTIONS = [
1053
+ "preview",
1054
+ "clean",
1055
+ "status",
1056
+ "cancel",
1057
+ "reclaim"
1058
+ ];
1059
+ const keyframesArgs = {
1060
+ action: positional({
1061
+ type: oneOf(KEYFRAMES_ACTIONS),
1062
+ displayName: "action",
1063
+ description: "preview: report what a clean-up would remove, without writing. clean: apply the configured keep and remove the keyframes of deleted documents (needs --yes). status: show the latest run and reclaim. cancel: stop a running clean-up. reclaim: rewrite the Keyframe table to give the space back to the disk."
1064
+ }),
1065
+ url: option({
1066
+ type: optional(string),
1067
+ long: "url",
1068
+ description: "The switchboard's GraphQL endpoint, e.g. http://localhost:4001/graphql. Defaults to reactor.port in powerhouse.config.json."
1069
+ }),
1070
+ token: option({
1071
+ type: optional(string),
1072
+ long: "token",
1073
+ description: "Admin bearer token. Defaults to PH_ACCESS_TOKEN, then a token from your `ph login` identity. Its address must be in the host's auth admins."
1074
+ }),
1075
+ yes: flag({
1076
+ type: optional(boolean),
1077
+ long: "yes",
1078
+ description: "Confirms a clean or a reclaim; both refuse to run without it."
1079
+ }),
1080
+ json: flag({
1081
+ type: optional(boolean),
1082
+ long: "json",
1083
+ description: "Print the result as JSON."
1084
+ }),
1085
+ ...debugArgs
1086
+ };
1087
+ //#endregion
1051
1088
  //#region clis/args/list.ts
1052
1089
  const listArgs = { ...debugArgs };
1053
1090
  //#endregion
@@ -1423,6 +1460,7 @@ const phCliCommandNames = [
1423
1460
  "registry-login",
1424
1461
  "inspect",
1425
1462
  "is",
1463
+ "keyframes",
1426
1464
  "mcp",
1427
1465
  "migrate",
1428
1466
  "switchboard",
@@ -1522,6 +1560,12 @@ const allPhCliHelpCommands = {
1522
1560
  description: "Serve the project's reactor-mcp tools over stdio, starting Vetra on the first tool call",
1523
1561
  handler: () => {}
1524
1562
  }),
1563
+ keyframes: helpCommand({
1564
+ name: "keyframes",
1565
+ args: keyframesArgs,
1566
+ description: "Report on and clean up the keyframes of a running switchboard",
1567
+ handler: () => {}
1568
+ }),
1525
1569
  migrate: helpCommand({
1526
1570
  name: "migrate",
1527
1571
  args: migrateArgs,
@@ -7162,7 +7206,19 @@ const connectCompositionEntrySchema = z.strictObject({
7162
7206
  /** A switchboard Connect routes to, from one of the host's remote backends. */
7163
7207
  const connectRemoteBackendSchema = z.strictObject({
7164
7208
  name: z.string().min(1).describe("The backend's key in the host config."),
7165
- url: z.string().describe("A drive address on the switchboard: <switchboard>/d/<slug>.")
7209
+ url: z.string().describe("A drive address on the switchboard: <switchboard>/d/<slug>."),
7210
+ requestTimeoutMs: z.number().int().positive().optional().describe("Give up on one request after this long. Default 30000."),
7211
+ breaker: z.union([z.literal(false), z.strictObject({
7212
+ failures: z.number().int().min(1).optional(),
7213
+ openMs: z.number().int().nonnegative().optional()
7214
+ })]).optional().describe("After `failures` failed requests in a row, send nothing for `openMs`. false: never stop trying."),
7215
+ realtime: z.boolean().optional().describe("Live updates over a socket. Default true.")
7216
+ });
7217
+ /** The router settings a host sets for Connect. */
7218
+ const connectRouterSettingsSchema = z.strictObject({
7219
+ newDrives: z.string().min(1).optional().describe("The remoteBackends[].name new drives are created on, with no copy in this browser. Absent: the browser reactor, else the only switchboard."),
7220
+ probeTimeoutMs: z.number().int().nonnegative().optional(),
7221
+ provisionalRouteMs: z.number().int().nonnegative().optional()
7166
7222
  });
7167
7223
  /** `sync: false` keeps no copy in this browser; unset means true. */
7168
7224
  const connectCollectionSchema = z.strictObject({
@@ -7173,7 +7229,8 @@ const connectCollectionSchema = z.strictObject({
7173
7229
  const connectRuntimeInstanceSchema = connectInstanceSchema.extend({
7174
7230
  reactorClient: connectReactorClientModeSchema.optional(),
7175
7231
  remoteBackends: z.array(connectRemoteBackendSchema).optional(),
7176
- collections: z.record(z.string(), connectCollectionSchema).optional()
7232
+ collections: z.record(z.string(), connectCollectionSchema).optional(),
7233
+ router: connectRouterSettingsSchema.optional()
7177
7234
  });
7178
7235
  /** A remote default drive plus the backend serving it. */
7179
7236
  const connectRuntimeDefaultDriveRemoteSchema = connectDefaultDriveRemoteSchema.extend({
@@ -7235,6 +7292,22 @@ function emitJsonSchemaFragment(schema) {
7235
7292
  const phConnectRuntimeConfigSchema = /* @__PURE__ */ emitJsonSchemaFragment(connectConfigSchema);
7236
7293
  //#endregion
7237
7294
  //#region clis/source-config-schema.ts
7295
+ const keyframeRuleSchema = {
7296
+ type: "object",
7297
+ additionalProperties: false,
7298
+ properties: {
7299
+ interval: {
7300
+ type: "integer",
7301
+ minimum: 1,
7302
+ description: "Write a keyframe every N revisions."
7303
+ },
7304
+ keep: {
7305
+ type: ["integer", "null"],
7306
+ minimum: 1,
7307
+ description: "Keyframes kept per document stream, newest first; null keeps them all."
7308
+ }
7309
+ }
7310
+ };
7238
7311
  const SOURCE_CONFIG_SCHEMA_ID = "https://powerhouse.inc/schemas/powerhouse.source.json";
7239
7312
  const sourceConfigSchema = {
7240
7313
  $schema: "http://json-schema.org/draft-07/schema#",
@@ -7336,6 +7409,22 @@ const sourceConfigSchema = {
7336
7409
  description: "Required when `type: postgres`."
7337
7410
  }
7338
7411
  }
7412
+ },
7413
+ keyframes: {
7414
+ type: "object",
7415
+ additionalProperties: false,
7416
+ description: "How many keyframes a document stream keeps and how often one is written. Without this block: a keyframe every 10 revisions, all kept. `PH_KEYFRAMES` overrides it.",
7417
+ properties: {
7418
+ default: {
7419
+ ...keyframeRuleSchema,
7420
+ description: "The rule for every type `types` does not name."
7421
+ },
7422
+ types: {
7423
+ type: "object",
7424
+ description: "Rules by exact document type, over `default`.",
7425
+ additionalProperties: keyframeRuleSchema
7426
+ }
7427
+ }
7339
7428
  }
7340
7429
  }
7341
7430
  },
@@ -7505,6 +7594,6 @@ function assertNodeVersion(nodeVersion = process.versions.node) {
7505
7594
  if (lt(nodeVersion, "24.0.0")) throw new NodeVersionError(nodeVersion, MINIMUM_NODE_VERSION);
7506
7595
  }
7507
7596
  //#endregion
7508
- export { AGENTS, ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_DEPENDENCY_OVERRIDES, DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_DRIVE_ICON, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_LOGIN_EXPIRY, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, KYSELY_PACKAGE, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, MINIMUM_NODE_VERSION, NodeVersionError, PEER_EXTERNAL_DEPENDENCIES, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, PIECES_FRAMEWORK_PACKAGE, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, PROJECT_PORT_BAND_SIZE, PROJECT_PORT_BAND_STUDIO, PROJECT_PORT_BAND_SWITCHBOARD, PROJECT_PORT_BAND_VETRA_CONNECT, REACTOR_API_PACKAGE, RELATIONAL_DB_PROCESSOR_CLASS, SECONDS_IN_DAY, SERVICE_ACTIONS, SOURCE_CONFIG_SCHEMA_ID, SpawnError, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, accessTokenArgs, assertNodeVersion, buildArgs, buildPnpmLink, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectConfigArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, defaultManifest, defaultStoreDirs, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, externalDependencies, externalDevDependencies, fetchNpmVersionFromRegistryForTag, fetchPackageVersionFromNpmRegistry, fileExists, fileExistsSync, force, generateArgs, getConfig, getGlobalPowerhouseProjectDirPath, getLocalPowerhouseProjectDirPath, getPackageManagerAtPowerhouseProjectDirPath, getPackageManagerCommand, getPackageNameFromPackageJson, getPackageVersionFromPackageJson, getPhCliVersionInfo, getPhCmdVersionInfo, getPowerhouseProjectInfo, getPowerhouseProjectInstallCommand, getPowerhouseProjectUninstallCommand, getTagFromVersion, getTelemetryStatus, handleMutuallyExclusiveOptions, https, httpsCertFile, httpsKeyFile, initArgs, initCliTelemetry, injectPnpmAllowBuilds, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, lowestVersion, makeDependenciesWithVersions, makeVersionedDependencies, makeVersionedDependenciesMap, migrateArgs, packageJsonExports, packageManagerArgs, packageScripts, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, registryLoginArgs, renownNamespace, renownSwitchboardUrl, resolveConnectPortDefault, resolvePhDir, resolveSwitchboardPortDefault, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, sourceConfigSchema, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, versionSatisfies, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
7597
+ export { AGENTS, ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_DEPENDENCY_OVERRIDES, DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_DRIVE_ICON, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_LOGIN_EXPIRY, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, KEYFRAMES_ACTIONS, KYSELY_PACKAGE, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, MINIMUM_NODE_VERSION, NodeVersionError, PEER_EXTERNAL_DEPENDENCIES, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, PIECES_FRAMEWORK_PACKAGE, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, PROJECT_PORT_BAND_SIZE, PROJECT_PORT_BAND_STUDIO, PROJECT_PORT_BAND_SWITCHBOARD, PROJECT_PORT_BAND_VETRA_CONNECT, REACTOR_API_PACKAGE, RELATIONAL_DB_PROCESSOR_CLASS, SECONDS_IN_DAY, SERVICE_ACTIONS, SOURCE_CONFIG_SCHEMA_ID, SpawnError, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, accessTokenArgs, assertNodeVersion, buildArgs, buildPnpmLink, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectConfigArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, defaultManifest, defaultStoreDirs, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, externalDependencies, externalDevDependencies, fetchNpmVersionFromRegistryForTag, fetchPackageVersionFromNpmRegistry, fileExists, fileExistsSync, force, generateArgs, getConfig, getGlobalPowerhouseProjectDirPath, getLocalPowerhouseProjectDirPath, getPackageManagerAtPowerhouseProjectDirPath, getPackageManagerCommand, getPackageNameFromPackageJson, getPackageVersionFromPackageJson, getPhCliVersionInfo, getPhCmdVersionInfo, getPowerhouseProjectInfo, getPowerhouseProjectInstallCommand, getPowerhouseProjectUninstallCommand, getTagFromVersion, getTelemetryStatus, handleMutuallyExclusiveOptions, https, httpsCertFile, httpsKeyFile, initArgs, initCliTelemetry, injectPnpmAllowBuilds, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, keyframesArgs, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, lowestVersion, makeDependenciesWithVersions, makeVersionedDependencies, makeVersionedDependenciesMap, migrateArgs, packageJsonExports, packageManagerArgs, packageScripts, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, registryLoginArgs, renownNamespace, renownSwitchboardUrl, resolveConnectPortDefault, resolvePhDir, resolveSwitchboardPortDefault, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, sourceConfigSchema, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, versionSatisfies, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
7509
7598
 
7510
7599
  //# sourceMappingURL=index.mjs.map