@wildo-ai/platform-core-shared 1.1.10 → 1.1.12

package/dist/esm/runtime/local-dev-runtime-signals.contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-dev-runtime-signals.contracts.js","sourceRoot":"","sources":["../../../src/runtime/local-dev-runtime-signals.contracts.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\n/**\n * The local dev loop's two RUNTIME-SIGNAL records: what an application package's compiler last did, and what the\n * supervisor of an application runtime (the backend) is doing (#3212, #3214, #3215, #3216).\n *\n * ## Why these live here, beside the backend's start record\n *\n * Both records were born in the monorepo's dev orchestrator (`scripts/dev-orchestrator/local-dev-protocol.mjs`), a\n * dependency-free script that only a FRAMEWORK DEVELOPER's application runs. An application created from the published\n * framework (app-creator mode) ran neither: its shared library was `tsc-watch` plus a `tsc-alias` pass, and its backend\n * was `node dist/index.js` started from the backend's own `tsc-watch --onSuccess`. Four defects of\n * `app-creation-test-007` followed from that one absence:\n *\n * - nothing restarted the backend when the shared library it imports was rebuilt, so a tree that was already fixed stayed\n *   down for 46 minutes (#3215);\n * - the backend could start between the shared library's `tsc` emit and its alias pass, read extensionless imports and\n *   die with `ERR_MODULE_NOT_FOUND`, and nothing brought it back (#3216);\n * - a backend left behind by an earlier generation kept the port and served stale code while every rebuild's start died\n *   on \"port in use\", and a watcher dead since a laptop sleep was never noticed (#3214);\n * - the companion read the application's packages the instant a playbook had written their sources, before their\n *   compiler had published, and stopped the whole creation loop on one stale read (#3212).\n *\n * The published framework now ships the writer of both records (`wildo-dev-runtime`, the program of\n * `@wildo-ai/wildo-dev-runtime`, which runs this package's `./dev-runtime` code, #3263), so the same files exist in both\n * modes, at the same paths, in the same shape. The companion reads them through THIS module and the\n * framework-developer scripts keep writing them from their own copy of the vocabulary, which is why the values below\n * are pinned against that script by a test rather than restated by hand.\n *\n * ## Where they live\n *\n * Under the application's runtime-signals home, `<app>/.wildo-saas/runtime-signals/`:\n * `compilers/<package file name>.json` for a compiler, `supervisors/<label>.json` for a runtime supervisor.\n */\n\n/** The protocol version both records carry. A reader refuses any other value rather than guessing its meaning. */\nexport const LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION = 1;\n\n/** The application-relative runtime-signals home every record below lives under. */\nexport const APPLICATION_RUNTIME_SIGNALS_RELATIVE_DIRECTORY = '.wildo-saas/runtime-signals';\n\n/** The directory, under the runtime-signals home, holding one compile observation per application package. */\nexport const LOCAL_DEV_COMPILE_OBSERVATIONS_DIRECTORY = 'compilers';\n\n/** The directory, under the runtime-signals home, holding one record per supervised runtime. */\nexport const LOCAL_DEV_SUPERVISOR_OBSERVATIONS_DIRECTORY = 'supervisors';\n\nexport const LOCAL_DEV_COMPILE_OBSERVATION_KIND = 'wildo.local-dev.compile-observation';\nexport const LOCAL_DEV_SUPERVISOR_OBSERVATION_KIND = 'wildo.local-dev.supervisor-observation';\n\n/**\n * What an application package's compiler is doing. A package's `dist` may be READ only while its compiler is `READY`:\n * every other state means the output is being written, or was left half-written, or is not being kept current at all.\n */\nexport enum LocalDevCompileState {\n  /** The compiler is starting and has not finished its first compilation. */\n  STARTING = 'STARTING',\n  /** `tsc` reported a compilation START and has not reported its end: it may be writing `dist` right now. */\n  COMPILING = 'COMPILING',\n  /**\n   * `tsc` finished with no error and the post-emit pass (the import-specifier rewrite) is running. The emitted files\n   * still carry extensionless relative imports that Node cannot resolve until this pass ends — the window #3216 measured.\n   */\n  FINALIZING = 'FINALIZING',\n  /** The last compilation finished, its post-emit pass completed, and the emitted tree was verified. `dist` is current. */\n  READY = 'READY',\n  /** The last compilation reported errors, or its post-emit pass failed. `dist` holds an earlier or a partial build. */\n  FAILED = 'FAILED',\n  /** The compiler is not running. Nothing keeps `dist` current. */\n  STOPPED = 'STOPPED',\n}\n\n/** What a runtime supervisor is doing with the runtime it owns. */\nexport enum LocalDevSupervisorState {\n  /** Waiting to start the runtime: its build or a dependency's is not published yet, or a restart is under way. */\n  STARTING = 'STARTING',\n  /** The runtime is running and was started by this supervisor. */\n  RUNNING = 'RUNNING',\n  /** The runtime exited unexpectedly and a respawn is scheduled after a backoff. */\n  BACKOFF = 'BACKOFF',\n  /**\n   * The supervisor will not start the runtime until something changes: `blocker` says what (a crash budget spent, a\n   * port another process holds). A new build of a package it loads resets it.\n   */\n  PAUSED = 'PAUSED',\n  /** The supervisor stopped and its runtime with it. */\n  STOPPED = 'STOPPED',\n}\n\n/**\n * Why a supervisor is not running its runtime, as a closed vocabulary a reader can branch on.\n *\n * Kept apart from the free-text blockers the monorepo's supervisor publishes (a readiness reason, a migration owed)\n * because the remedy differs per member: a held port is the dev stack's, a crash loop is usually a dependency that is\n * down (#3365), and a spent budget is the application's own startup refusing. The `.mjs` mirror is\n * `LocalDevSupervisorBlocker` in `scripts/dev-orchestrator/local-dev-protocol.mjs`.\n */\nexport enum LocalDevSupervisorBlocker {\n  /**\n   * PAUSED: the runtime crashed at every respawn of its budget AND its own startup refused (its start record says\n   * `startup-refused`), so a new build of a package it loads is what fixes it, and starts it again.\n   */\n  CRASH_RESPAWN_EXHAUSTED = 'CRASH_RESPAWN_EXHAUSTED',\n  /**\n   * BACKOFF past the budget (#3365): the runtime keeps crashing and the supervisor keeps restarting it, the delay\n   * doubling up to a cap and never stopping (Kubernetes' CrashLoopBackOff). Published when the cause is a dependency\n   * that did not answer, or cannot be told: a database that comes back must bring its runtime back by itself.\n   * A reader treats it like a pause for \"is the application up?\": the runtime is not running between attempts.\n   */\n  CRASH_LOOP_BACKOFF = 'CRASH_LOOP_BACKOFF',\n  /**\n   * A process this supervisor did not spawn listens on the runtime's port, so every start dies binding it. The record's\n   * `portHolder` names it. The supervisor starts the runtime the moment the port is free.\n   */\n  PORT_HELD_BY_FOREIGN_PROCESS = 'PORT_HELD_BY_FOREIGN_PROCESS',\n  /**\n   * STOPPED (#2149): an app-creator COMPANION's supervisor (`wildo-dev-companion-supervised`) saw it crash more times\n   * than its window tolerates, stopped restarting it, and exited. Unlike {@link CRASH_RESPAWN_EXHAUSTED}, no build\n   * starts it again: only restarting `wildo local dev` does, after the cause in its log is fixed. The record outlives\n   * its producer on purpose, which is how `wildo local dev-status` can say the companion is down and why.\n   */\n  CRASH_LOOP_GAVE_UP = 'CRASH_LOOP_GAVE_UP',\n  /**\n   * PAUSED (#3552): a dependency install is re-creating the application's `node_modules` (the build applied a\n   * composition scenario, or a person ran an install). A start now would boot against a half-installed tree, so the\n   * runtime is held, and a crash in this window is not counted against its budget. It starts again, with a fresh\n   * budget, the moment the install ends. See {@link LocalDevDependencyInstallRecord_Schema}.\n   */\n  DEPENDENCY_INSTALL_IN_FLIGHT = 'DEPENDENCY_INSTALL_IN_FLIGHT',\n}\n\n/**\n * The application-relative file, under the runtime-signals home, that says a dependency install is running in the\n * application, or when the last one ended (#3552). See {@link LocalDevDependencyInstallRecord_Schema}.\n */\nexport const LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_FILE = 'dependency-install.json';\nexport const LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_KIND = 'wildo.local-dev.dependency-install';\n\n/**\n * Where a dependency install stands, as every dev-loop reader of {@link LocalDevDependencyInstallRecord_Schema} judges it.\n */\nexport enum LocalDevDependencyInstallPhase {\n  /** No install has been recorded in this application. */\n  NONE = 'NONE',\n  /** An install is running: its writer is alive and its deadline has not passed. Nothing may start on the tree. */\n  IN_FLIGHT = 'IN_FLIGHT',\n  /**\n   * The install is over: it finished (successfully or not), its writer died without finishing, or it outlived its\n   * deadline. Everything that compiled or started before it ended read a tree that has since changed.\n   */\n  ENDED = 'ENDED',\n}\n\nconst isoTimestamp = z.string().refine((value) => Number.isFinite(Date.parse(value)), 'an ISO-8601 timestamp');\n\n/**\n * The process found listening on a port. That SOMETHING listens is established by connecting to it; who it is comes\n * from the operating system's tools (`lsof`, `ps`), which a host may lack, so every field but `port` may be unknown.\n */\nexport const LocalDevPortHolder_Schema = z.object({\n  port: z.number().int().positive(),\n  pid: z.number().int().positive().nullable(),\n  /** The holder's parent. `1` means it was re-parented to the init process: its own parent is gone (an orphan). */\n  ppid: z.number().int().nonnegative().nullable(),\n  /** When the holder started, as `ps` reports it. */\n  startedAt: z.string().nullable(),\n  /** The holder's working directory. */\n  cwd: z.string().nullable(),\n  /** The holder's command line, truncated. */\n  command: z.string().nullable(),\n});\nexport type LocalDevPortHolder = z.infer<typeof LocalDevPortHolder_Schema>;\n\n/**\n * One application package's compiler, as its observer last published it. Loose (unknown keys kept) because the framework\n * developer's observer writes further fields (its diagnostic, its producer kind) that no reader here depends on.\n */\nexport const LocalDevCompileObservation_Schema = z.looseObject({\n  kind: z.literal(LOCAL_DEV_COMPILE_OBSERVATION_KIND),\n  schemaVersion: z.literal(LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION),\n  producerPid: z.number().int().positive(),\n  /** The compiler process the producer owns, or null when none runs. */\n  childPid: z.number().int().positive().nullable(),\n  appRoot: z.string().min(1),\n  packageRoot: z.string().min(1),\n  packageName: z.string().min(1),\n  state: z.enum(LocalDevCompileState),\n  heartbeatAt: isoTimestamp,\n  updatedAt: isoTimestamp,\n  /** When the compiler last reported a compilation start. */\n  lastCompilationStartedAt: isoTimestamp.nullable(),\n  /** When a compilation last ended READY: emitted, post-processed and verified. */\n  lastSuccessfulCompileAt: isoTimestamp.nullable(),\n  lastFailureAt: isoTimestamp.nullable(),\n  lastErrorCount: z.number().int().nonnegative().nullable(),\n});\nexport type LocalDevCompileObservation = z.infer<typeof LocalDevCompileObservation_Schema>;\n\n/** One supervised runtime. Loose for the same reason as the compile observation. */\nexport const LocalDevSupervisorObservation_Schema = z.looseObject({\n  kind: z.literal(LOCAL_DEV_SUPERVISOR_OBSERVATION_KIND),\n  schemaVersion: z.literal(LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION),\n  producerPid: z.number().int().positive(),\n  label: z.string().min(1),\n  state: z.enum(LocalDevSupervisorState),\n  childPid: z.number().int().positive().nullable(),\n  /** When the current (or last) runtime child was started. */\n  childStartedAt: isoTimestamp.nullable().optional(),\n  /** A free-text reason (the monorepo supervisor's), or one of {@link LocalDevSupervisorBlocker}. */\n  blocker: z.string().nullable(),\n  /** Set with {@link LocalDevSupervisorBlocker.PORT_HELD_BY_FOREIGN_PROCESS}: the process that holds the port. */\n  portHolder: LocalDevPortHolder_Schema.nullable().optional(),\n  /**\n   * The file whose change asks this supervisor to restart its runtime (`<runtime-signals home>/<label>.signal`); `null`\n   * when the supervisor honours no such request. ABSENT from a writer that predates the field, which a reader treats as\n   * the conventional `<label>.signal` (the CLI does). Three writers set it: the monorepo's `runtime-supervisor.mjs`\n   * since #1031 and `wildo-dev-runtime serve` since #2134, each to its file (which is how `wildo secrets set` brings a\n   * changed key to a created application's running backend, minion or worker), and the app-creator companion's\n   * supervisor since #2149, to `null`: it honours no request, because the companion loads a changed key in place.\n   */\n  signalFilePath: z.string().min(1).nullable().optional(),\n  updatedAt: isoTimestamp,\n});\nexport type LocalDevSupervisorObservation = z.infer<typeof LocalDevSupervisorObservation_Schema>;\n\n/**\n * A dependency install in an application, as its installer records it (#3552).\n *\n * ## Why it exists\n *\n * `pnpm install` re-creates the application's `node_modules` while `wildo local dev` runs against it. Measured on\n * reference run 42666728304 (2026-11-09): the build's foundation step applied composition scenarios that added four\n * minions and a documentation site, and installed them (16 s). In that window every compile watcher compiled against a\n * half-installed tree (`TS2318 Cannot find global type 'Array'`, `TS6053 lib.dom.d.ts not found`) and nothing ever asked\n * it to compile again; the backend's readiness stayed blocked on those failures; every companion introspection worker\n * died on `Cannot find package 'zod'`; and the install re-created the virtual-store key of `@wildo-ai/framework-knowledge`\n * without its compiled knowledge tree, so `GET /api/companion/creation/questions` answered 500 for as long as the run\n * was watched. Nothing tied the install to the running stack.\n *\n * So the installer writes this record before the install (`finishedAt: null`) and again when it ends, and every dev-loop\n * process reads it: a runtime supervisor HOLDS its runtime while the install is in flight and does not count a crash\n * against its budget, then relaunches it (and, in a framework checkout, repairs the injected snapshots first); a\n * compile observer restarts a watcher whose last compile began before the install ended.\n *\n * ## Why a pid and a deadline rather than a heartbeat\n *\n * Every other in-flight signal here is a heartbeat refreshed from a timer. An install is often run SYNCHRONOUSLY\n * (`spawnSync` in the CLI), so no timer would beat during it. The writer's pid answers \"still running?\" and the\n * deadline bounds a writer that hangs, so a record can never hold the stack for good.\n *\n * ## Why it is never removed\n *\n * The finished record is what tells a watcher that started compiling before the install ended to compile again. It is a\n * cache in the sense of `one-source-of-truth.md`: deleting it costs one missed relaunch, never a fact.\n */\nexport const LocalDevDependencyInstallRecord_Schema = z.looseObject({\n  kind: z.literal(LOCAL_DEV_DEPENDENCY_INSTALL_RECORD_KIND),\n  schemaVersion: z.literal(LOCAL_DEV_RUNTIME_SIGNALS_PROTOCOL_VERSION),\n  /** The process running the install (the companion, or the CLI). */\n  pid: z.number().int().positive(),\n  startedAt: isoTimestamp,\n  /** Past this instant the install is treated as ended, whatever its writer says. */\n  deadlineAt: isoTimestamp,\n  /** When the install ended, or `null` while it runs. */\n  finishedAt: isoTimestamp.nullable(),\n  /** Whether it succeeded, or `null` while it runs. */\n  succeeded: z.boolean().nullable(),\n  /** Who installed, for a reader of the record: `foundation`, `wildo update`, … */\n  initiator: z.string().min(1),\n});\nexport type LocalDevDependencyInstallRecord = z.infer<typeof LocalDevDependencyInstallRecord_Schema>;\n"]}

package/dist/esm/runtime/runtime-topology.contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-topology.contracts.js","sourceRoot":"","sources":["../../../../src/runtime/runtime-topology.contracts.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  BackendApiType,\n  StaticFrontEndType,\n} from '@wildo-ai/saas-models';\n\nexport interface RuntimeEndpointUrls {\n  publicUrl: string;\n  internalUrl: string;\n}\n\n/**\n * Shared application/service identifiers for platform-owned runtimes.\n *\n * This enum must live in the shared contract layer because CLI/runtime topology\n * code needs these semantics without importing backend runtime packages.\n */\nexport enum PlatformApplicationType {\n  PLATFORM_APPS_MANAGER = 'platform_apps_manager',\n  PLATFORM_CRONTABS_BATCHES_MANAGER = 'platform_crontabs_batches_manager',\n  PLATFORM_MODULE_REGISTRY = 'platform_module_registry',\n  APP_LIFECYCLE_MANAGER = 'app_lifecycle_manager',\n  APP_CICD = 'app_cicd',\n  PLATFORM_CICD = 'platform_cicd',\n}\n\n/**\n * Shared runtime endpoint keys for platform services.\n *\n * These are the subset of `PlatformApplicationType` that expose runtime\n * endpoints directly.\n */\nexport enum PlatformRuntimeEndpointKey {\n  PLATFORM_APPS_MANAGER = PlatformApplicationType.PLATFORM_APPS_MANAGER,\n  PLATFORM_CRONTABS_BATCHES_MANAGER = PlatformApplicationType.PLATFORM_CRONTABS_BATCHES_MANAGER,\n  PLATFORM_MODULE_REGISTRY = PlatformApplicationType.PLATFORM_MODULE_REGISTRY,\n}\n\nexport interface PlatformRuntimeEndpointsInput {\n  appsManager: RuntimeEndpointUrls;\n  crontabsBatchesManager: RuntimeEndpointUrls;\n  /**\n   * Module-registry endpoint (Phase 3 / KD-7). Optional during the\n   * Phase 3 rollout: existing platform deployments that haven't\n   * yet provisioned the registry pass `undefined` and the entry\n   * is omitted from the resulting record. New deployments + every\n   * Phase 4+ caller MUST set it.\n   */\n  moduleRegistry?: RuntimeEndpointUrls;\n}\n\nexport function buildPlatformRuntimeEndpoints(\n  input: PlatformRuntimeEndpointsInput,\n): Record<string, RuntimeEndpointUrls> {\n  const out: Record<string, RuntimeEndpointUrls> = {\n    [PlatformRuntimeEndpointKey.PLATFORM_APPS_MANAGER]: input.appsManager,\n    [PlatformRuntimeEndpointKey.PLATFORM_CRONTABS_BATCHES_MANAGER]: input.crontabsBatchesManager,\n  };\n  if (input.moduleRegistry) {\n    out[PlatformRuntimeEndpointKey.PLATFORM_MODULE_REGISTRY] = input.moduleRegistry;\n  }\n  return out;\n}\n\nexport interface ApplicationRuntimeEndpointsInput {\n  frontendApplications?: Record<string, RuntimeEndpointUrls> | undefined;\n  website?: RuntimeEndpointUrls | undefined;\n  technicalDocumentation?: RuntimeEndpointUrls | undefined;\n  mainBackendApi?: RuntimeEndpointUrls | undefined;\n}\n\nexport function buildApplicationRuntimeEndpoints(\n  input: ApplicationRuntimeEndpointsInput,\n): Record<string, RuntimeEndpointUrls> {\n  const endPoints: Record<string, RuntimeEndpointUrls> = {\n    ...(input.frontendApplications ?? {}),\n  };\n  if (input.website) {\n    endPoints[StaticFrontEndType.WEBSITE] = input.website;\n  }\n  if (input.technicalDocumentation) {\n    endPoints[StaticFrontEndType.TECHNICAL_DOCUMENTATION] = input.technicalDocumentation;\n  }\n  if (input.mainBackendApi) {\n    endPoints[BackendApiType.MAIN_BACKEND_API] = input.mainBackendApi;\n  }\n\n  return endPoints;\n}\n\nexport function serializeRuntimeEndpointsRecord(\n  endPoints: Record<string, RuntimeEndpointUrls>,\n): string {\n  return JSON.stringify(endPoints);\n}\n\nexport function parseRuntimeEndpointsRecord(\n  serializedRuntimeEndpoints: string,\n): Record<string, RuntimeEndpointUrls> {\n  const parsed = JSON.parse(serializedRuntimeEndpoints) as unknown;\n  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    throw new Error('Runtime endpoints payload must be a JSON object');\n  }\n\n  const record: Record<string, RuntimeEndpointUrls> = {};\n  for (const [key, value] of Object.entries(parsed)) {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n      throw new Error(`Runtime endpoint \"${key}\" must be an object`);\n    }\n\n    const publicUrl = (value as Record<string, unknown>).publicUrl;\n    const internalUrl = (value as Record<string, unknown>).internalUrl;\n    if (typeof publicUrl !== 'string' || typeof internalUrl !== 'string') {\n      throw new Error(`Runtime endpoint \"${key}\" must expose string publicUrl/internalUrl`);\n    }\n\n    record[key] = { publicUrl, internalUrl };\n  }\n\n  return record;\n}\n"]}
+{"version":3,"file":"runtime-topology.contracts.js","sourceRoot":"","sources":["../../../src/runtime/runtime-topology.contracts.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  BackendApiType,\n  StaticFrontEndType,\n} from '@wildo-ai/saas-models';\n\nexport interface RuntimeEndpointUrls {\n  publicUrl: string;\n  internalUrl: string;\n}\n\n/**\n * Shared application/service identifiers for platform-owned runtimes.\n *\n * This enum must live in the shared contract layer because CLI/runtime topology\n * code needs these semantics without importing backend runtime packages.\n */\nexport enum PlatformApplicationType {\n  PLATFORM_APPS_MANAGER = 'platform_apps_manager',\n  PLATFORM_CRONTABS_BATCHES_MANAGER = 'platform_crontabs_batches_manager',\n  PLATFORM_MODULE_REGISTRY = 'platform_module_registry',\n  APP_LIFECYCLE_MANAGER = 'app_lifecycle_manager',\n  APP_CICD = 'app_cicd',\n  PLATFORM_CICD = 'platform_cicd',\n}\n\n/**\n * Shared runtime endpoint keys for platform services.\n *\n * These are the subset of `PlatformApplicationType` that expose runtime\n * endpoints directly.\n */\nexport enum PlatformRuntimeEndpointKey {\n  PLATFORM_APPS_MANAGER = PlatformApplicationType.PLATFORM_APPS_MANAGER,\n  PLATFORM_CRONTABS_BATCHES_MANAGER = PlatformApplicationType.PLATFORM_CRONTABS_BATCHES_MANAGER,\n  PLATFORM_MODULE_REGISTRY = PlatformApplicationType.PLATFORM_MODULE_REGISTRY,\n}\n\nexport interface PlatformRuntimeEndpointsInput {\n  appsManager: RuntimeEndpointUrls;\n  crontabsBatchesManager: RuntimeEndpointUrls;\n  /**\n   * Module-registry endpoint (Phase 3 / KD-7). Optional during the\n   * Phase 3 rollout: existing platform deployments that haven't\n   * yet provisioned the registry pass `undefined` and the entry\n   * is omitted from the resulting record. New deployments + every\n   * Phase 4+ caller MUST set it.\n   */\n  moduleRegistry?: RuntimeEndpointUrls;\n}\n\nexport function buildPlatformRuntimeEndpoints(\n  input: PlatformRuntimeEndpointsInput,\n): Record<string, RuntimeEndpointUrls> {\n  const out: Record<string, RuntimeEndpointUrls> = {\n    [PlatformRuntimeEndpointKey.PLATFORM_APPS_MANAGER]: input.appsManager,\n    [PlatformRuntimeEndpointKey.PLATFORM_CRONTABS_BATCHES_MANAGER]: input.crontabsBatchesManager,\n  };\n  if (input.moduleRegistry) {\n    out[PlatformRuntimeEndpointKey.PLATFORM_MODULE_REGISTRY] = input.moduleRegistry;\n  }\n  return out;\n}\n\nexport interface ApplicationRuntimeEndpointsInput {\n  frontendApplications?: Record<string, RuntimeEndpointUrls> | undefined;\n  website?: RuntimeEndpointUrls | undefined;\n  technicalDocumentation?: RuntimeEndpointUrls | undefined;\n  mainBackendApi?: RuntimeEndpointUrls | undefined;\n}\n\nexport function buildApplicationRuntimeEndpoints(\n  input: ApplicationRuntimeEndpointsInput,\n): Record<string, RuntimeEndpointUrls> {\n  const endPoints: Record<string, RuntimeEndpointUrls> = {\n    ...(input.frontendApplications ?? {}),\n  };\n  if (input.website) {\n    endPoints[StaticFrontEndType.WEBSITE] = input.website;\n  }\n  if (input.technicalDocumentation) {\n    endPoints[StaticFrontEndType.TECHNICAL_DOCUMENTATION] = input.technicalDocumentation;\n  }\n  if (input.mainBackendApi) {\n    endPoints[BackendApiType.MAIN_BACKEND_API] = input.mainBackendApi;\n  }\n\n  return endPoints;\n}\n\nexport function serializeRuntimeEndpointsRecord(\n  endPoints: Record<string, RuntimeEndpointUrls>,\n): string {\n  return JSON.stringify(endPoints);\n}\n\nexport function parseRuntimeEndpointsRecord(\n  serializedRuntimeEndpoints: string,\n): Record<string, RuntimeEndpointUrls> {\n  const parsed = JSON.parse(serializedRuntimeEndpoints) as unknown;\n  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    throw new Error('Runtime endpoints payload must be a JSON object');\n  }\n\n  const record: Record<string, RuntimeEndpointUrls> = {};\n  for (const [key, value] of Object.entries(parsed)) {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n      throw new Error(`Runtime endpoint \"${key}\" must be an object`);\n    }\n\n    const publicUrl = (value as Record<string, unknown>).publicUrl;\n    const internalUrl = (value as Record<string, unknown>).internalUrl;\n    if (typeof publicUrl !== 'string' || typeof internalUrl !== 'string') {\n      throw new Error(`Runtime endpoint \"${key}\" must expose string publicUrl/internalUrl`);\n    }\n\n    record[key] = { publicUrl, internalUrl };\n  }\n\n  return record;\n}\n"]}

package/dist/esm/security/authorizations/roles.custom.shared.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"roles.custom.shared.definitions.js","sourceRoot":"","sources":["../../../../../src/security/authorizations/roles.custom.shared.definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,0BAA0B,GAAuB,EAE7D,CAAC","sourcesContent":["import { RolesConfiguration, ResourcePrimaryScope } from \"@wildo-ai/saas-models\";\n\nexport const CUSTOM_ROLES_CONFIGURATION: RolesConfiguration = {\n  \n};\n\n"]}
+{"version":3,"file":"roles.custom.shared.definitions.js","sourceRoot":"","sources":["../../../../src/security/authorizations/roles.custom.shared.definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,0BAA0B,GAAuB,EAE7D,CAAC","sourcesContent":["import { RolesConfiguration, ResourcePrimaryScope } from \"@wildo-ai/saas-models\";\n\nexport const CUSTOM_ROLES_CONFIGURATION: RolesConfiguration = {\n  \n};\n\n"]}