@sixb/core 0.1.13 → 0.1.15

package/dist/deploy/define.d.ts

@@ -0,0 +1,4 @@
+import type { DeployConfig } from "./types";
+/** Declares a deployment in `sixb.deploy.ts`. `sixb deploy` validates it when it loads the file. */
+export declare function defineDeploy<const TConfig extends DeployConfig>(config: TConfig): TConfig;
+//# sourceMappingURL=define.d.ts.map

package/dist/deploy/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/deploy/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,KAAK,CAAC,OAAO,SAAS,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAEzF"}

package/dist/deploy/index.d.ts

@@ -0,0 +1,3 @@
+export { defineDeploy } from "./define";
+export type { DeployAccess, DeployAccessKey, DeployCheck, DeployCheckContext, DeployCi, DeployCiCredential, DeployCommand, DeployConfig, DeployConfigurableWorkerType, DeployContext, DeployControlAction, DeployEnv, DeployEvent, DeployHttpServiceConfig, DeployHttpServiceName, DeployListenAddress, DeployLogsOptions, DeployOperationContext, DeployProcessDefinition, DeployProcessOptions, DeployProcessStatus, DeployRecord, DeployRelease, DeployReleaseHttp, DeployReleaseProcess, DeployReleaseService, DeployScalableProcessOptions, DeployServiceName, DeployServicesConfig, DeploySetupContext, DeploySingletonServiceConfig, DeploySingletonServiceName, DeploySource, DeploySourceArchive, DeployStatus, DeployTarget, DeployWorkersConfig, DeployWorkerType, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/deploy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deploy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,4BAA4B,EAC5B,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,0BAA0B,EAC1B,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAA"}

package/dist/deploy/index.js

@@ -0,0 +1,10 @@
+// @bun
+// src/deploy/define.ts
+function defineDeploy(config) {
+  return config;
+}
+export {
+  defineDeploy
+};
+
+//# debugId=988A26A9EC64ED7164756E2164756E21

package/dist/deploy/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/deploy/define.ts"],
+  "sourcesContent": [
+    "import type { DeployConfig } from \"./types\"\n\n/** Declares a deployment in `sixb.deploy.ts`. `sixb deploy` validates it when it loads the file. */\nexport function defineDeploy<const TConfig extends DeployConfig>(config: TConfig): TConfig {\n  return config\n}\n"
+  ],
+  "mappings": ";;AAGO,SAAS,YAAgD,CAAC,QAA0B;AAAA,EACzF,OAAO;AAAA;",
+  "debugId": "988A26A9EC64ED7164756E2164756E21",
+  "names": []
+}

package/dist/deploy/internal.d.ts

@@ -0,0 +1,3 @@
+export { DEPLOY_SERVICES, DEPLOY_WORKER_TYPES, isDeployHttpService, isDeploySingletonService, } from "./services";
+export { validateDeployConfig } from "./validation";
+//# sourceMappingURL=internal.d.ts.map

package/dist/deploy/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/deploy/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA"}

package/dist/deploy/internal.js

@@ -0,0 +1,244 @@
+// @bun
+// src/deploy/services.ts
+var SERVICES = {
+  api: "http",
+  atlas: "http",
+  app: "http",
+  orchestrator: "singleton",
+  scheduler: "singleton",
+  rules: "singleton",
+  workers: "workers"
+};
+var WORKER_TYPES = {
+  sync: true,
+  action: false,
+  agent: true,
+  pipeline: true,
+  projection: true,
+  workflow: true
+};
+var DEPLOY_SERVICES = Object.keys(SERVICES);
+var DEPLOY_WORKER_TYPES = Object.keys(WORKER_TYPES);
+var DEPLOY_CONFIGURABLE_WORKER_TYPES = DEPLOY_WORKER_TYPES.filter((workerType) => WORKER_TYPES[workerType]);
+function isDeployHttpService(service) {
+  return SERVICES[service] === "http";
+}
+function isDeploySingletonService(service) {
+  return SERVICES[service] === "singleton";
+}
+// src/deploy/validation.ts
+var NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+var DOMAIN_LABEL = "[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?";
+var DOMAIN_PATTERN = new RegExp(`^${DOMAIN_LABEL}(?:\\.${DOMAIN_LABEL})*$`, "i");
+var ENV_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
+var MEMORY_PATTERN = /^\d+(?:\.\d+)?\s*(?:b|k|kb|m|mb|g|gb)?$/i;
+var MAX_TIMER_MS = 2147483647;
+var PROCESS_OPTIONS = ["killTimeoutMs", "restartDelayMs", "maxMemory"];
+var SCALABLE_PROCESS_OPTIONS = [...PROCESS_OPTIONS, "instances"];
+function validateDeployConfig(value) {
+  const config = record(value, "The deploy config");
+  knownKeys(config, ["name", "domain", "target", "env", "services", "processes"], "");
+  name(config.name, "name");
+  if (config.domain !== undefined)
+    domain(config.domain, "domain");
+  target(config.target);
+  if (config.env !== undefined)
+    env(config.env, "env");
+  if (config.services !== undefined)
+    services(config.services);
+  if (config.processes !== undefined)
+    processes(config.processes);
+  return value;
+}
+function target(value) {
+  const hint = "Use a deploy target, such as `new SshTarget({ host })` from @sixb/deploy-ssh.";
+  if (typeof value !== "object" || value === null) {
+    throw new Error(`[SixbDeploy] target is required. ${hint}`);
+  }
+  const candidate = value;
+  const methods = ["listenAddress", "deploy", "status", "logs", "control", "check"];
+  if (typeof candidate.kind !== "string" || typeof candidate.location !== "string" || methods.some((method) => typeof candidate[method] !== "function")) {
+    throw new Error(`[SixbDeploy] target is not a deploy target. ${hint}`);
+  }
+}
+function services(value) {
+  const config = record(value, "services");
+  knownKeys(config, DEPLOY_SERVICES, "services");
+  for (const service of DEPLOY_SERVICES) {
+    const override = config[service];
+    if (override === undefined || typeof override === "boolean")
+      continue;
+    const path = `services.${service}`;
+    const options = record(override, path);
+    if (isDeployHttpService(service)) {
+      knownKeys(options, ["domain", "env", "process"], path, {
+        port: "Ports belong to the target, such as `new SshTarget({ ports: { api: 3012 } })`."
+      });
+      if (options.domain !== undefined)
+        domain(options.domain, `${path}.domain`);
+      if (options.process !== undefined) {
+        processOptions(options.process, `${path}.process`, PROCESS_OPTIONS, {
+          instances: "HTTP services run one process each."
+        });
+      }
+    } else if (isDeploySingletonService(service)) {
+      knownKeys(options, ["env", "process"], path);
+      if (options.process !== undefined) {
+        processOptions(options.process, `${path}.process`, PROCESS_OPTIONS, {
+          instances: `The ${service} runs exactly one process: a second would duplicate its work.`
+        });
+      }
+    } else {
+      knownKeys(options, ["types", "agentTurnTimeout", "concurrency", "env", "process"], path);
+      if (options.types !== undefined)
+        workerTypes(options.types, `${path}.types`);
+      if (options.agentTurnTimeout !== undefined) {
+        string(options.agentTurnTimeout, `${path}.agentTurnTimeout`);
+      }
+      if (options.concurrency !== undefined) {
+        workerConcurrency(options.concurrency, `${path}.concurrency`);
+      }
+      if (options.process !== undefined) {
+        processOptions(options.process, `${path}.process`, SCALABLE_PROCESS_OPTIONS);
+      }
+    }
+    if (options.env !== undefined)
+      env(options.env, `${path}.env`);
+  }
+}
+function processes(value) {
+  const config = record(value, "processes");
+  for (const [processName, definition] of Object.entries(config)) {
+    const path = `processes.${processName}`;
+    name(processName, path);
+    if (DEPLOY_SERVICES.includes(processName)) {
+      throw new Error(`[SixbDeploy] ${path} uses the name of a Sixb service. Rename the process.`);
+    }
+    const options = record(definition, path);
+    knownKeys(options, ["entrypoint", "args", "env", "process"], path);
+    entrypoint(options.entrypoint, `${path}.entrypoint`);
+    if (options.args !== undefined) {
+      if (!Array.isArray(options.args) || options.args.some((arg) => typeof arg !== "string")) {
+        throw new Error(`[SixbDeploy] ${path}.args must be an array of strings.`);
+      }
+    }
+    if (options.env !== undefined)
+      env(options.env, `${path}.env`);
+    if (options.process !== undefined) {
+      processOptions(options.process, `${path}.process`, SCALABLE_PROCESS_OPTIONS);
+    }
+  }
+}
+function workerTypes(value, path) {
+  if (value === "all")
+    return;
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error(`[SixbDeploy] ${path} must be "all" or a non-empty list of worker types.`);
+  }
+  const seen = new Set;
+  for (const workerType of value) {
+    if (!DEPLOY_WORKER_TYPES.includes(workerType)) {
+      throw new Error(`[SixbDeploy] ${path} has unknown worker type ${JSON.stringify(workerType)}. ` + `Available: ${DEPLOY_WORKER_TYPES.join(", ")}.`);
+    }
+    if (seen.has(workerType)) {
+      throw new Error(`[SixbDeploy] ${path} lists ${workerType} more than once.`);
+    }
+    seen.add(workerType);
+  }
+}
+function workerConcurrency(value, path) {
+  const config = record(value, path);
+  for (const [workerType, concurrency] of Object.entries(config)) {
+    if (workerType === "action") {
+      throw new Error(`[SixbDeploy] ${path}.action cannot be set: action jobs run one at a time.`);
+    }
+    if (!DEPLOY_CONFIGURABLE_WORKER_TYPES.includes(workerType)) {
+      throw new Error(`[SixbDeploy] ${path} has unknown worker type "${workerType}". ` + `Available: ${DEPLOY_CONFIGURABLE_WORKER_TYPES.join(", ")}.`);
+    }
+    positiveInteger(concurrency, `${path}.${workerType}`);
+  }
+}
+function processOptions(value, path, allowed, hints = {}) {
+  const options = record(value, path);
+  knownKeys(options, allowed, path, hints);
+  if (options.instances !== undefined)
+    positiveInteger(options.instances, `${path}.instances`);
+  if (options.killTimeoutMs !== undefined) {
+    positiveInteger(options.killTimeoutMs, `${path}.killTimeoutMs`, MAX_TIMER_MS);
+  }
+  if (options.restartDelayMs !== undefined) {
+    positiveInteger(options.restartDelayMs, `${path}.restartDelayMs`, MAX_TIMER_MS);
+  }
+  if (options.maxMemory !== undefined) {
+    if (typeof options.maxMemory !== "string" || !MEMORY_PATTERN.test(options.maxMemory.trim())) {
+      throw new Error(`[SixbDeploy] ${path}.maxMemory must be a size such as "512M" or "2G".`);
+    }
+  }
+}
+function entrypoint(value, path) {
+  string(value, path);
+  const segments = value.split(/[\\/]/);
+  if (value.startsWith("/") || segments.includes("..")) {
+    throw new Error(`[SixbDeploy] ${path} must be a path inside the project, relative to its directory.`);
+  }
+}
+function env(value, path) {
+  const variables = record(value, path);
+  for (const [key, variable] of Object.entries(variables)) {
+    if (!ENV_NAME_PATTERN.test(key)) {
+      throw new Error(`[SixbDeploy] ${path}.${key} is not a valid environment variable name. ` + "Use uppercase letters, digits, and underscores.");
+    }
+    if (typeof variable !== "string") {
+      throw new Error(`[SixbDeploy] ${path}.${key} must be a string.`);
+    }
+  }
+}
+function name(value, path) {
+  string(value, path);
+  if (!NAME_PATTERN.test(value) || value.length > 63) {
+    throw new Error(`[SixbDeploy] ${path} must use lowercase letters, numbers, and hyphens, ` + "start and end with a letter or number, and be at most 63 characters.");
+  }
+}
+function domain(value, path) {
+  string(value, path);
+  if (value.includes("://") || value.includes("/")) {
+    throw new Error(`[SixbDeploy] ${path} must be a hostname such as app.example.com, not a URL.`);
+  }
+  if (value.length > 253 || !DOMAIN_PATTERN.test(value)) {
+    throw new Error(`[SixbDeploy] ${path} must be a valid hostname such as app.example.com.`);
+  }
+}
+function positiveInteger(value, path, maximum = Number.MAX_SAFE_INTEGER) {
+  if (!Number.isInteger(value) || value < 1 || value > maximum) {
+    throw new Error(`[SixbDeploy] ${path} must be a positive integer.`);
+  }
+}
+function string(value, path) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error(`[SixbDeploy] ${path} must be a non-empty string.`);
+  }
+}
+function record(value, path) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error(`[SixbDeploy] ${path} must be an object.`);
+  }
+  return value;
+}
+function knownKeys(value, allowed, path, hints = {}) {
+  for (const key of Object.keys(value)) {
+    if (allowed.includes(key))
+      continue;
+    const setting = path ? `${path}.${key}` : key;
+    const hint = hints[key] ?? `Available: ${allowed.join(", ")}.`;
+    throw new Error(`[SixbDeploy] Unknown deploy setting '${setting}'. ${hint}`);
+  }
+}
+export {
+  DEPLOY_SERVICES,
+  DEPLOY_WORKER_TYPES,
+  isDeployHttpService,
+  isDeploySingletonService,
+  validateDeployConfig
+};
+
+//# debugId=0E2C47DFD73C115364756E2164756E21

package/dist/deploy/internal.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/deploy/services.ts", "../src/deploy/validation.ts"],
+  "sourcesContent": [
+    "import type {\n  DeployConfigurableWorkerType,\n  DeployHttpServiceName,\n  DeployServiceName,\n  DeploySingletonServiceName,\n  DeployWorkerType,\n} from \"./types\"\n\n// Records rather than arrays so that each list is total over its union: a service or worker type\n// added to the types does not compile until it is listed here, and validation accepts it.\n\nconst SERVICES = {\n  api: \"http\",\n  atlas: \"http\",\n  app: \"http\",\n  orchestrator: \"singleton\",\n  scheduler: \"singleton\",\n  rules: \"singleton\",\n  workers: \"workers\",\n} as const satisfies Record<DeployServiceName, \"http\" | \"singleton\" | \"workers\">\n\n/** Whether each worker type's concurrency can be configured. */\nconst WORKER_TYPES: {\n  readonly [Type in DeployWorkerType]: Type extends DeployConfigurableWorkerType ? true : false\n} = {\n  sync: true,\n  action: false,\n  agent: true,\n  pipeline: true,\n  projection: true,\n  workflow: true,\n}\n\n/** Every service, in the order a deployment lists them. */\nexport const DEPLOY_SERVICES = Object.keys(SERVICES) as DeployServiceName[]\n\nexport const DEPLOY_WORKER_TYPES = Object.keys(WORKER_TYPES) as DeployWorkerType[]\n\nexport const DEPLOY_CONFIGURABLE_WORKER_TYPES = DEPLOY_WORKER_TYPES.filter(\n  (workerType): workerType is DeployConfigurableWorkerType => WORKER_TYPES[workerType]\n)\n\nexport function isDeployHttpService(service: DeployServiceName): service is DeployHttpServiceName {\n  return SERVICES[service] === \"http\"\n}\n\nexport function isDeploySingletonService(\n  service: DeployServiceName\n): service is DeploySingletonServiceName {\n  return SERVICES[service] === \"singleton\"\n}\n",
+    "import {\n  DEPLOY_CONFIGURABLE_WORKER_TYPES,\n  DEPLOY_SERVICES,\n  DEPLOY_WORKER_TYPES,\n  isDeployHttpService,\n  isDeploySingletonService,\n} from \"./services\"\nimport type { DeployConfig } from \"./types\"\n\ntype UnknownRecord = Record<string, unknown>\n\nconst NAME_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/\nconst DOMAIN_LABEL = \"[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\"\nconst DOMAIN_PATTERN = new RegExp(`^${DOMAIN_LABEL}(?:\\\\.${DOMAIN_LABEL})*$`, \"i\")\nconst ENV_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/\nconst MEMORY_PATTERN = /^\\d+(?:\\.\\d+)?\\s*(?:b|k|kb|m|mb|g|gb)?$/i\n/** Longest delay a timer honors; anything larger fires immediately. */\nconst MAX_TIMER_MS = 2_147_483_647\n\nconst PROCESS_OPTIONS = [\"killTimeoutMs\", \"restartDelayMs\", \"maxMemory\"] as const\nconst SCALABLE_PROCESS_OPTIONS = [...PROCESS_OPTIONS, \"instances\"] as const\n\n/**\n * Checks a loaded `sixb.deploy.ts` default export and returns it typed. Validates shape and\n * values only; `sixb deploy` resolves defaults and checks what depends on the target.\n */\nexport function validateDeployConfig(value: unknown): DeployConfig {\n  const config = record(value, \"The deploy config\")\n  knownKeys(config, [\"name\", \"domain\", \"target\", \"env\", \"services\", \"processes\"], \"\")\n\n  name(config.name, \"name\")\n  if (config.domain !== undefined) domain(config.domain, \"domain\")\n  target(config.target)\n  if (config.env !== undefined) env(config.env, \"env\")\n  if (config.services !== undefined) services(config.services)\n  if (config.processes !== undefined) processes(config.processes)\n\n  return value as DeployConfig\n}\n\nfunction target(value: unknown): void {\n  const hint = \"Use a deploy target, such as `new SshTarget({ host })` from @sixb/deploy-ssh.\"\n  if (typeof value !== \"object\" || value === null) {\n    throw new Error(`[SixbDeploy] target is required. ${hint}`)\n  }\n  const candidate = value as UnknownRecord\n  const methods = [\"listenAddress\", \"deploy\", \"status\", \"logs\", \"control\", \"check\"]\n  if (\n    typeof candidate.kind !== \"string\" ||\n    typeof candidate.location !== \"string\" ||\n    methods.some((method) => typeof candidate[method] !== \"function\")\n  ) {\n    throw new Error(`[SixbDeploy] target is not a deploy target. ${hint}`)\n  }\n}\n\nfunction services(value: unknown): void {\n  const config = record(value, \"services\")\n  knownKeys(config, DEPLOY_SERVICES, \"services\")\n\n  for (const service of DEPLOY_SERVICES) {\n    const override = config[service]\n    if (override === undefined || typeof override === \"boolean\") continue\n    const path = `services.${service}`\n    const options = record(override, path)\n\n    if (isDeployHttpService(service)) {\n      knownKeys(options, [\"domain\", \"env\", \"process\"], path, {\n        port: \"Ports belong to the target, such as `new SshTarget({ ports: { api: 3012 } })`.\",\n      })\n      if (options.domain !== undefined) domain(options.domain, `${path}.domain`)\n      if (options.process !== undefined) {\n        processOptions(options.process, `${path}.process`, PROCESS_OPTIONS, {\n          instances: \"HTTP services run one process each.\",\n        })\n      }\n    } else if (isDeploySingletonService(service)) {\n      knownKeys(options, [\"env\", \"process\"], path)\n      if (options.process !== undefined) {\n        processOptions(options.process, `${path}.process`, PROCESS_OPTIONS, {\n          instances: `The ${service} runs exactly one process: a second would duplicate its work.`,\n        })\n      }\n    } else {\n      knownKeys(options, [\"types\", \"agentTurnTimeout\", \"concurrency\", \"env\", \"process\"], path)\n      if (options.types !== undefined) workerTypes(options.types, `${path}.types`)\n      if (options.agentTurnTimeout !== undefined) {\n        string(options.agentTurnTimeout, `${path}.agentTurnTimeout`)\n      }\n      if (options.concurrency !== undefined) {\n        workerConcurrency(options.concurrency, `${path}.concurrency`)\n      }\n      if (options.process !== undefined) {\n        processOptions(options.process, `${path}.process`, SCALABLE_PROCESS_OPTIONS)\n      }\n    }\n\n    if (options.env !== undefined) env(options.env, `${path}.env`)\n  }\n}\n\nfunction processes(value: unknown): void {\n  const config = record(value, \"processes\")\n\n  for (const [processName, definition] of Object.entries(config)) {\n    const path = `processes.${processName}`\n    name(processName, path)\n    if ((DEPLOY_SERVICES as readonly string[]).includes(processName)) {\n      throw new Error(`[SixbDeploy] ${path} uses the name of a Sixb service. Rename the process.`)\n    }\n\n    const options = record(definition, path)\n    knownKeys(options, [\"entrypoint\", \"args\", \"env\", \"process\"], path)\n    entrypoint(options.entrypoint, `${path}.entrypoint`)\n    if (options.args !== undefined) {\n      if (!Array.isArray(options.args) || options.args.some((arg) => typeof arg !== \"string\")) {\n        throw new Error(`[SixbDeploy] ${path}.args must be an array of strings.`)\n      }\n    }\n    if (options.env !== undefined) env(options.env, `${path}.env`)\n    if (options.process !== undefined) {\n      processOptions(options.process, `${path}.process`, SCALABLE_PROCESS_OPTIONS)\n    }\n  }\n}\n\nfunction workerTypes(value: unknown, path: string): void {\n  if (value === \"all\") return\n  if (!Array.isArray(value) || value.length === 0) {\n    throw new Error(`[SixbDeploy] ${path} must be \"all\" or a non-empty list of worker types.`)\n  }\n  const seen = new Set<string>()\n  for (const workerType of value) {\n    if (!(DEPLOY_WORKER_TYPES as readonly unknown[]).includes(workerType)) {\n      throw new Error(\n        `[SixbDeploy] ${path} has unknown worker type ${JSON.stringify(workerType)}. ` +\n          `Available: ${DEPLOY_WORKER_TYPES.join(\", \")}.`\n      )\n    }\n    if (seen.has(workerType)) {\n      throw new Error(`[SixbDeploy] ${path} lists ${workerType} more than once.`)\n    }\n    seen.add(workerType)\n  }\n}\n\nfunction workerConcurrency(value: unknown, path: string): void {\n  const config = record(value, path)\n  for (const [workerType, concurrency] of Object.entries(config)) {\n    if (workerType === \"action\") {\n      throw new Error(`[SixbDeploy] ${path}.action cannot be set: action jobs run one at a time.`)\n    }\n    if (!(DEPLOY_CONFIGURABLE_WORKER_TYPES as readonly string[]).includes(workerType)) {\n      throw new Error(\n        `[SixbDeploy] ${path} has unknown worker type \"${workerType}\". ` +\n          `Available: ${DEPLOY_CONFIGURABLE_WORKER_TYPES.join(\", \")}.`\n      )\n    }\n    positiveInteger(concurrency, `${path}.${workerType}`)\n  }\n}\n\nfunction processOptions(\n  value: unknown,\n  path: string,\n  allowed: readonly string[],\n  hints: Readonly<Record<string, string>> = {}\n): void {\n  const options = record(value, path)\n  knownKeys(options, allowed, path, hints)\n  if (options.instances !== undefined) positiveInteger(options.instances, `${path}.instances`)\n  if (options.killTimeoutMs !== undefined) {\n    positiveInteger(options.killTimeoutMs, `${path}.killTimeoutMs`, MAX_TIMER_MS)\n  }\n  if (options.restartDelayMs !== undefined) {\n    positiveInteger(options.restartDelayMs, `${path}.restartDelayMs`, MAX_TIMER_MS)\n  }\n  if (options.maxMemory !== undefined) {\n    if (typeof options.maxMemory !== \"string\" || !MEMORY_PATTERN.test(options.maxMemory.trim())) {\n      throw new Error(`[SixbDeploy] ${path}.maxMemory must be a size such as \"512M\" or \"2G\".`)\n    }\n  }\n}\n\nfunction entrypoint(value: unknown, path: string): void {\n  string(value, path)\n  const segments = value.split(/[\\\\/]/)\n  if (value.startsWith(\"/\") || segments.includes(\"..\")) {\n    throw new Error(\n      `[SixbDeploy] ${path} must be a path inside the project, relative to its directory.`\n    )\n  }\n}\n\nfunction env(value: unknown, path: string): void {\n  const variables = record(value, path)\n  for (const [key, variable] of Object.entries(variables)) {\n    if (!ENV_NAME_PATTERN.test(key)) {\n      throw new Error(\n        `[SixbDeploy] ${path}.${key} is not a valid environment variable name. ` +\n          \"Use uppercase letters, digits, and underscores.\"\n      )\n    }\n    if (typeof variable !== \"string\") {\n      throw new Error(`[SixbDeploy] ${path}.${key} must be a string.`)\n    }\n  }\n}\n\nfunction name(value: unknown, path: string): void {\n  string(value, path)\n  if (!NAME_PATTERN.test(value) || value.length > 63) {\n    throw new Error(\n      `[SixbDeploy] ${path} must use lowercase letters, numbers, and hyphens, ` +\n        \"start and end with a letter or number, and be at most 63 characters.\"\n    )\n  }\n}\n\nfunction domain(value: unknown, path: string): void {\n  string(value, path)\n  if (value.includes(\"://\") || value.includes(\"/\")) {\n    throw new Error(`[SixbDeploy] ${path} must be a hostname such as app.example.com, not a URL.`)\n  }\n  if (value.length > 253 || !DOMAIN_PATTERN.test(value)) {\n    throw new Error(`[SixbDeploy] ${path} must be a valid hostname such as app.example.com.`)\n  }\n}\n\nfunction positiveInteger(value: unknown, path: string, maximum = Number.MAX_SAFE_INTEGER): void {\n  if (!Number.isInteger(value) || (value as number) < 1 || (value as number) > maximum) {\n    throw new Error(`[SixbDeploy] ${path} must be a positive integer.`)\n  }\n}\n\nfunction string(value: unknown, path: string): asserts value is string {\n  if (typeof value !== \"string\" || value.trim() === \"\") {\n    throw new Error(`[SixbDeploy] ${path} must be a non-empty string.`)\n  }\n}\n\nfunction record(value: unknown, path: string): UnknownRecord {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new Error(`[SixbDeploy] ${path} must be an object.`)\n  }\n  return value as UnknownRecord\n}\n\nfunction knownKeys(\n  value: UnknownRecord,\n  allowed: readonly string[],\n  path: string,\n  hints: Readonly<Record<string, string>> = {}\n): void {\n  for (const key of Object.keys(value)) {\n    if (allowed.includes(key)) continue\n    const setting = path ? `${path}.${key}` : key\n    const hint = hints[key] ?? `Available: ${allowed.join(\", \")}.`\n    throw new Error(`[SixbDeploy] Unknown deploy setting '${setting}'. ${hint}`)\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "0E2C47DFD73C115364756E2164756E21",
+  "names": []
+}

package/dist/deploy/services.d.ts

@@ -0,0 +1,8 @@
+import type { DeployConfigurableWorkerType, DeployHttpServiceName, DeployServiceName, DeploySingletonServiceName, DeployWorkerType } from "./types";
+/** Every service, in the order a deployment lists them. */
+export declare const DEPLOY_SERVICES: DeployServiceName[];
+export declare const DEPLOY_WORKER_TYPES: DeployWorkerType[];
+export declare const DEPLOY_CONFIGURABLE_WORKER_TYPES: DeployConfigurableWorkerType[];
+export declare function isDeployHttpService(service: DeployServiceName): service is DeployHttpServiceName;
+export declare function isDeploySingletonService(service: DeployServiceName): service is DeploySingletonServiceName;
+//# sourceMappingURL=services.d.ts.map

package/dist/deploy/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/deploy/services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,SAAS,CAAA;AA2BhB,2DAA2D;AAC3D,eAAO,MAAM,eAAe,EAA4B,iBAAiB,EAAE,CAAA;AAE3E,eAAO,MAAM,mBAAmB,EAAgC,gBAAgB,EAAE,CAAA;AAElF,eAAO,MAAM,gCAAgC,gCAE5C,CAAA;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,IAAI,qBAAqB,CAEhG;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,iBAAiB,GACzB,OAAO,IAAI,0BAA0B,CAEvC"}