@geekmidas/cli 10.0.0-alpha.61 → 10.0.0-alpha.63

package/dist/config.d.cts

@@ -1,211 +1,4 @@
-import { C as WorkspaceConfig, _ as LoadedConfig, b as NormalizedWorkspace, p as DevConfig, r as GkmConfig, y as NormalizedAppConfig } from "./types-efNLu9xu.cjs";
-import { i as defineWorkspace } from "./index-UiWCaGzU.cjs";
-import { ConstructManifest } from "@geekmidas/manifest";
-//#region src/dev/discovery.d.ts
-/** Where an app is in its life. `stopped` is a server that exited on its own. */
-type AppStatus = 'starting' | 'ready' | 'reloading' | 'stopped';
-/** A JSON API an app serves about itself. */
-type DataApiKind = 'telescope' | 'database' | 'openapi';
-interface DiscoveredDataApi {
-  kind: DataApiKind;
-  /** Where the app serves it. */
-  path: string;
-  /** The app's own address for it — `http://localhost:<port><path>`. */
-  url: string;
-  /** The same API through this endpoint, relative to its origin. */
-  proxy: string;
-}
-interface DiscoveredApp {
-  name: string;
-  type: 'backend' | 'web' | 'mobile';
-  port: number;
-  /** `http://localhost:<port>`. */
-  url: string;
-  publicUrl: string | null;
-  status: AppStatus;
-  reloads: number;
-  /** The `gkm dev` running it, when it runs in one of its own. */
-  pid: number | null;
-  dataApis: DiscoveredDataApi[];
-}
-interface DiscoveredWorkspace {
-  /** Stable for a workspace's root: its name, and a hash of where it is. */
-  id: string;
-  name: string;
-  root: string;
-  stage: string;
-  manifest: ConstructManifest | null;
-  apps: DiscoveredApp[];
-}
-/** The body of `GET /__gkm`. */
-interface DiscoveryResponse {
-  version: 1;
-  /** The `gkm dev` serving this endpoint, which may change while you watch. */
-  host: {
-    pid: number;
-    port: number;
-  };
-  /** Where the changes stream, as server-sent events. */
-  events: string;
-  workspaces: DiscoveredWorkspace[];
-}
-/** One message on `GET /__gkm/events`; its SSE `event:` is its `type`. */
-type DiscoveryEvent = {
-  type: 'snapshot';
-  snapshot: DiscoveryResponse;
-} | {
-  type: 'workspace.started' | 'workspace.stopped';
-  workspace: string;
-} | {
-  type: 'app.started' | 'app.stopped' | 'app.reloaded' | 'app.status';
-  workspace: string;
-  app: DiscoveredApp;
-};
-//#endregion
-//#region src/config.d.ts
-/**
- * Define GKM configuration with full TypeScript support.
- * This is an identity function that provides type safety and autocomplete.
- *
- * @example
- * ```ts
- * // gkm.config.ts
- * import { defineConfig } from '@geekmidas/cli/config';
- *
- * export default defineConfig({
- *   routes: './src/endpoints/**\/*.ts',
- *   envParser: './src/config/env',
- *   logger: './src/config/logger',
- *   telescope: true,
- * });
- * ```
- */
-export declare function defineConfig(config: GkmConfig): GkmConfig;
-export interface ParsedModuleConfig {
-  path: string;
-  importPattern: string;
-}
-/**
- * Parse a module config string into path and import pattern.
- *
- * @param configString - Config string in format "./path/to/module" or "./path/to/module#exportName"
- * @param defaultAlias - The default alias name to use if no export name specified
- * @returns Object with path and import pattern
- *
- * @example
- * parseModuleConfig('./src/config/env', 'envParser')
- * // { path: './src/config/env', importPattern: 'envParser' }
- *
- * parseModuleConfig('./src/config/env#envParser', 'envParser')
- * // { path: './src/config/env', importPattern: '{ envParser }' }
- *
- * parseModuleConfig('./src/config/env#myEnv', 'envParser')
- * // { path: './src/config/env', importPattern: '{ myEnv as envParser }' }
- */
-export declare function parseModuleConfig(configString: string, defaultAlias: string): ParsedModuleConfig;
-export interface ConfigDiscoveryResult {
-  configPath: string;
-  workspaceRoot: string;
-}
-/** No gkm config in a directory or any of its parents. */
-export declare class ConfigNotFound extends Error {
-  readonly cwd: string;
-  constructor(cwd: string);
-}
-/**
- * Load configuration file (single-app format).
- * For backwards compatibility with existing code.
- *
- * @deprecated Use loadWorkspaceConfig for new code
- */
-export declare function loadConfig(cwd?: string): Promise<GkmConfig>;
-/**
- * Load configuration file and process it as a workspace.
- * Works with both single-app and workspace configurations.
- *
- * Single-app configs are automatically wrapped as a workspace with one app.
- *
- * @example
- * ```ts
- * const { type, workspace } = await loadWorkspaceConfig();
- *
- * if (type === 'workspace') {
- *   console.log('Multi-app workspace:', workspace.apps);
- * } else {
- *   console.log('Single app wrapped as workspace');
- * }
- * ```
- */
-/**
- * The workspace a directory belongs to, as its config states it — without
- * discovering its constructs.
- *
- * For callers that need a fact the config holds (where a stage's secrets are
- * stored) and nothing the graph adds. `loadWorkspaceConfig` imports every
- * construct module to derive the apps, which is a cost a secrets read should
- * not pay.
- */
-export declare function loadWorkspaceSettings(cwd?: string): Promise<LoadedConfig['workspace']>;
-export declare function loadWorkspaceConfig(cwd?: string): Promise<LoadedConfig>;
-/**
- * A workspace with no `constructs` glob.
- *
- * In v10 every address, container and app comes from what the workspace
- * declares — there is no second path that reads a hand-written compose file or
- * an `apps` block's ports. A config that declares nothing has nothing to run.
- */
-export declare class WorkspaceDeclaresNoConstructs extends Error {
-  readonly root: string;
-  constructor(root: string);
-}
-export interface AppConfigResult {
-  appName: string;
-  app: NormalizedAppConfig;
-  gkmConfig: GkmConfig;
-  workspace: NormalizedWorkspace;
-  workspaceRoot: string;
-  appRoot: string;
-}
-/** A directory that no app in the workspace lives in. */
-export declare class NotInAnApp extends Error {
-  readonly cwd: string;
-  readonly apps: Readonly<Record<string, string>>;
-  constructor(cwd: string, apps: Readonly<Record<string, string>>);
-}
-/**
- * The backend app a directory is part of, with its gkm config — found by the
- * `path` its construct declares.
- *
- * @example
- * ```ts
- * // From apps/api, where a construct declares `path: 'apps/api'`
- * const { app, workspace, workspaceRoot } = await loadAppConfig();
- * ```
- *
- * @throws {NotInAnApp} when no app's path contains the directory.
- * @throws {NotABackendApp} when the app it is in has no gkm config to run.
- */
-export declare function loadAppConfig(cwd?: string): Promise<AppConfigResult>;
-/** The app a directory is in has no gkm config — a site, or an entry app. */
-export declare class NotABackendApp extends Error {
-  readonly appName: string;
-  constructor(appName: string);
-}
-export interface WorkspaceAppInfo {
-  /** The app's key in the workspace. */
-  appName: string;
-  app: NormalizedAppConfig;
-  workspace: NormalizedWorkspace;
-  workspaceRoot: string;
-}
-/**
- * The app a directory is part of, frontend or backend — found by the `path`
- * its construct declares. Unlike `loadAppConfig`, the app need not have a
- * gkm config, which is what `gkm exec` and `gkm test` from a site need.
- *
- * @throws {NotInAnApp} when no app's path contains the directory.
- */
-export declare function loadWorkspaceAppInfo(cwd?: string): Promise<WorkspaceAppInfo>;
-//#endregion
-export { type AppStatus, type DataApiKind, type DevConfig, type DiscoveredApp, type DiscoveredDataApi, type DiscoveredWorkspace, type DiscoveryEvent, type DiscoveryResponse, type GkmConfig, type LoadedConfig, type WorkspaceConfig, defineWorkspace };
-//# sourceMappingURL=config.d.cts.map
+import { C as WorkspaceConfig, _ as LoadedConfig, p as DevConfig, r as GkmConfig } from "./types-DIA7Li-J.cjs";
+import { i as defineWorkspace } from "./index-BtXDZQuF.cjs";
+import { C as DiscoveredApp, D as DiscoveryResponse, E as DiscoveryEvent, S as DataApiKind, T as DiscoveredWorkspace, _ as loadWorkspaceAppInfo, a as ConfigNotFound, b as parseModuleConfig, c as NotABackendApp, d as WorkspaceAppInfo, f as WorkspaceDeclaresNoConstructs, g as loadConfig, h as loadAppConfig, i as ConfigLoadFailed, l as NotInAnApp, m as findWorkspaceRoot, n as CONFIG_LOAD_TIMEOUT_MS, o as ConfigObjectNotSerializable, p as defineConfig, r as ConfigDiscoveryResult, s as LoadConfigOptions, t as AppConfigResult, u as ParsedModuleConfig, v as loadWorkspaceConfig, w as DiscoveredDataApi, x as AppStatus, y as loadWorkspaceSettings } from "./config-CemHVcIr.cjs";
+export { AppConfigResult, type AppStatus, CONFIG_LOAD_TIMEOUT_MS, ConfigDiscoveryResult, ConfigLoadFailed, ConfigNotFound, ConfigObjectNotSerializable, type DataApiKind, type DevConfig, type DiscoveredApp, type DiscoveredDataApi, type DiscoveredWorkspace, type DiscoveryEvent, type DiscoveryResponse, type GkmConfig, LoadConfigOptions, type LoadedConfig, NotABackendApp, NotInAnApp, ParsedModuleConfig, WorkspaceAppInfo, type WorkspaceConfig, WorkspaceDeclaresNoConstructs, defineConfig, defineWorkspace, findWorkspaceRoot, loadAppConfig, loadConfig, loadWorkspaceAppInfo, loadWorkspaceConfig, loadWorkspaceSettings, parseModuleConfig };

package/dist/config.d.mts

@@ -1,211 +1,4 @@
-import { C as WorkspaceConfig, _ as LoadedConfig, b as NormalizedWorkspace, p as DevConfig, r as GkmConfig, y as NormalizedAppConfig } from "./types-Bp1mVxG0.mjs";
-import { i as defineWorkspace } from "./index-Da1-oa9W.mjs";
-import { ConstructManifest } from "@geekmidas/manifest";
-//#region src/dev/discovery.d.ts
-/** Where an app is in its life. `stopped` is a server that exited on its own. */
-type AppStatus = 'starting' | 'ready' | 'reloading' | 'stopped';
-/** A JSON API an app serves about itself. */
-type DataApiKind = 'telescope' | 'database' | 'openapi';
-interface DiscoveredDataApi {
-  kind: DataApiKind;
-  /** Where the app serves it. */
-  path: string;
-  /** The app's own address for it — `http://localhost:<port><path>`. */
-  url: string;
-  /** The same API through this endpoint, relative to its origin. */
-  proxy: string;
-}
-interface DiscoveredApp {
-  name: string;
-  type: 'backend' | 'web' | 'mobile';
-  port: number;
-  /** `http://localhost:<port>`. */
-  url: string;
-  publicUrl: string | null;
-  status: AppStatus;
-  reloads: number;
-  /** The `gkm dev` running it, when it runs in one of its own. */
-  pid: number | null;
-  dataApis: DiscoveredDataApi[];
-}
-interface DiscoveredWorkspace {
-  /** Stable for a workspace's root: its name, and a hash of where it is. */
-  id: string;
-  name: string;
-  root: string;
-  stage: string;
-  manifest: ConstructManifest | null;
-  apps: DiscoveredApp[];
-}
-/** The body of `GET /__gkm`. */
-interface DiscoveryResponse {
-  version: 1;
-  /** The `gkm dev` serving this endpoint, which may change while you watch. */
-  host: {
-    pid: number;
-    port: number;
-  };
-  /** Where the changes stream, as server-sent events. */
-  events: string;
-  workspaces: DiscoveredWorkspace[];
-}
-/** One message on `GET /__gkm/events`; its SSE `event:` is its `type`. */
-type DiscoveryEvent = {
-  type: 'snapshot';
-  snapshot: DiscoveryResponse;
-} | {
-  type: 'workspace.started' | 'workspace.stopped';
-  workspace: string;
-} | {
-  type: 'app.started' | 'app.stopped' | 'app.reloaded' | 'app.status';
-  workspace: string;
-  app: DiscoveredApp;
-};
-//#endregion
-//#region src/config.d.ts
-/**
- * Define GKM configuration with full TypeScript support.
- * This is an identity function that provides type safety and autocomplete.
- *
- * @example
- * ```ts
- * // gkm.config.ts
- * import { defineConfig } from '@geekmidas/cli/config';
- *
- * export default defineConfig({
- *   routes: './src/endpoints/**\/*.ts',
- *   envParser: './src/config/env',
- *   logger: './src/config/logger',
- *   telescope: true,
- * });
- * ```
- */
-export declare function defineConfig(config: GkmConfig): GkmConfig;
-export interface ParsedModuleConfig {
-  path: string;
-  importPattern: string;
-}
-/**
- * Parse a module config string into path and import pattern.
- *
- * @param configString - Config string in format "./path/to/module" or "./path/to/module#exportName"
- * @param defaultAlias - The default alias name to use if no export name specified
- * @returns Object with path and import pattern
- *
- * @example
- * parseModuleConfig('./src/config/env', 'envParser')
- * // { path: './src/config/env', importPattern: 'envParser' }
- *
- * parseModuleConfig('./src/config/env#envParser', 'envParser')
- * // { path: './src/config/env', importPattern: '{ envParser }' }
- *
- * parseModuleConfig('./src/config/env#myEnv', 'envParser')
- * // { path: './src/config/env', importPattern: '{ myEnv as envParser }' }
- */
-export declare function parseModuleConfig(configString: string, defaultAlias: string): ParsedModuleConfig;
-export interface ConfigDiscoveryResult {
-  configPath: string;
-  workspaceRoot: string;
-}
-/** No gkm config in a directory or any of its parents. */
-export declare class ConfigNotFound extends Error {
-  readonly cwd: string;
-  constructor(cwd: string);
-}
-/**
- * Load configuration file (single-app format).
- * For backwards compatibility with existing code.
- *
- * @deprecated Use loadWorkspaceConfig for new code
- */
-export declare function loadConfig(cwd?: string): Promise<GkmConfig>;
-/**
- * Load configuration file and process it as a workspace.
- * Works with both single-app and workspace configurations.
- *
- * Single-app configs are automatically wrapped as a workspace with one app.
- *
- * @example
- * ```ts
- * const { type, workspace } = await loadWorkspaceConfig();
- *
- * if (type === 'workspace') {
- *   console.log('Multi-app workspace:', workspace.apps);
- * } else {
- *   console.log('Single app wrapped as workspace');
- * }
- * ```
- */
-/**
- * The workspace a directory belongs to, as its config states it — without
- * discovering its constructs.
- *
- * For callers that need a fact the config holds (where a stage's secrets are
- * stored) and nothing the graph adds. `loadWorkspaceConfig` imports every
- * construct module to derive the apps, which is a cost a secrets read should
- * not pay.
- */
-export declare function loadWorkspaceSettings(cwd?: string): Promise<LoadedConfig['workspace']>;
-export declare function loadWorkspaceConfig(cwd?: string): Promise<LoadedConfig>;
-/**
- * A workspace with no `constructs` glob.
- *
- * In v10 every address, container and app comes from what the workspace
- * declares — there is no second path that reads a hand-written compose file or
- * an `apps` block's ports. A config that declares nothing has nothing to run.
- */
-export declare class WorkspaceDeclaresNoConstructs extends Error {
-  readonly root: string;
-  constructor(root: string);
-}
-export interface AppConfigResult {
-  appName: string;
-  app: NormalizedAppConfig;
-  gkmConfig: GkmConfig;
-  workspace: NormalizedWorkspace;
-  workspaceRoot: string;
-  appRoot: string;
-}
-/** A directory that no app in the workspace lives in. */
-export declare class NotInAnApp extends Error {
-  readonly cwd: string;
-  readonly apps: Readonly<Record<string, string>>;
-  constructor(cwd: string, apps: Readonly<Record<string, string>>);
-}
-/**
- * The backend app a directory is part of, with its gkm config — found by the
- * `path` its construct declares.
- *
- * @example
- * ```ts
- * // From apps/api, where a construct declares `path: 'apps/api'`
- * const { app, workspace, workspaceRoot } = await loadAppConfig();
- * ```
- *
- * @throws {NotInAnApp} when no app's path contains the directory.
- * @throws {NotABackendApp} when the app it is in has no gkm config to run.
- */
-export declare function loadAppConfig(cwd?: string): Promise<AppConfigResult>;
-/** The app a directory is in has no gkm config — a site, or an entry app. */
-export declare class NotABackendApp extends Error {
-  readonly appName: string;
-  constructor(appName: string);
-}
-export interface WorkspaceAppInfo {
-  /** The app's key in the workspace. */
-  appName: string;
-  app: NormalizedAppConfig;
-  workspace: NormalizedWorkspace;
-  workspaceRoot: string;
-}
-/**
- * The app a directory is part of, frontend or backend — found by the `path`
- * its construct declares. Unlike `loadAppConfig`, the app need not have a
- * gkm config, which is what `gkm exec` and `gkm test` from a site need.
- *
- * @throws {NotInAnApp} when no app's path contains the directory.
- */
-export declare function loadWorkspaceAppInfo(cwd?: string): Promise<WorkspaceAppInfo>;
-//#endregion
-export { type AppStatus, type DataApiKind, type DevConfig, type DiscoveredApp, type DiscoveredDataApi, type DiscoveredWorkspace, type DiscoveryEvent, type DiscoveryResponse, type GkmConfig, type LoadedConfig, type WorkspaceConfig, defineWorkspace };
-//# sourceMappingURL=config.d.mts.map
+import { C as WorkspaceConfig, _ as LoadedConfig, p as DevConfig, r as GkmConfig } from "./types-CfLKGfC_.mjs";
+import { i as defineWorkspace } from "./index-DrKzpHl-.mjs";
+import { C as DiscoveredApp, D as DiscoveryResponse, E as DiscoveryEvent, S as DataApiKind, T as DiscoveredWorkspace, _ as loadWorkspaceAppInfo, a as ConfigNotFound, b as parseModuleConfig, c as NotABackendApp, d as WorkspaceAppInfo, f as WorkspaceDeclaresNoConstructs, g as loadConfig, h as loadAppConfig, i as ConfigLoadFailed, l as NotInAnApp, m as findWorkspaceRoot, n as CONFIG_LOAD_TIMEOUT_MS, o as ConfigObjectNotSerializable, p as defineConfig, r as ConfigDiscoveryResult, s as LoadConfigOptions, t as AppConfigResult, u as ParsedModuleConfig, v as loadWorkspaceConfig, w as DiscoveredDataApi, x as AppStatus, y as loadWorkspaceSettings } from "./config-C2BUosLm.mjs";
+export { AppConfigResult, type AppStatus, CONFIG_LOAD_TIMEOUT_MS, ConfigDiscoveryResult, ConfigLoadFailed, ConfigNotFound, ConfigObjectNotSerializable, type DataApiKind, type DevConfig, type DiscoveredApp, type DiscoveredDataApi, type DiscoveredWorkspace, type DiscoveryEvent, type DiscoveryResponse, type GkmConfig, LoadConfigOptions, type LoadedConfig, NotABackendApp, NotInAnApp, ParsedModuleConfig, WorkspaceAppInfo, type WorkspaceConfig, WorkspaceDeclaresNoConstructs, defineConfig, defineWorkspace, findWorkspaceRoot, loadAppConfig, loadConfig, loadWorkspaceAppInfo, loadWorkspaceConfig, loadWorkspaceSettings, parseModuleConfig };

package/dist/config.mjs

@@ -1,3 +1,3 @@
-import { a as defineConfig, c as loadWorkspaceAppInfo, d as parseModuleConfig, i as WorkspaceDeclaresNoConstructs, l as loadWorkspaceConfig, n as NotABackendApp, o as loadAppConfig, r as NotInAnApp, s as loadConfig, t as ConfigNotFound, u as loadWorkspaceSettings } from "./config-C5-EEdmr.mjs";
-import { i as defineWorkspace } from "./workspace-Bp1xVaOz.mjs";
-export { ConfigNotFound, NotABackendApp, NotInAnApp, WorkspaceDeclaresNoConstructs, defineConfig, defineWorkspace, loadAppConfig, loadConfig, loadWorkspaceAppInfo, loadWorkspaceConfig, loadWorkspaceSettings, parseModuleConfig };
+import { a as NotABackendApp, c as defineConfig, d as loadConfig, f as loadWorkspaceAppInfo, h as parseModuleConfig, i as ConfigObjectNotSerializable, l as findWorkspaceRoot, m as loadWorkspaceSettings, n as ConfigLoadFailed, o as NotInAnApp, p as loadWorkspaceConfig, r as ConfigNotFound, s as WorkspaceDeclaresNoConstructs, t as CONFIG_LOAD_TIMEOUT_MS, u as loadAppConfig } from "./config-LKKCVCnC.mjs";
+import { i as defineWorkspace } from "./workspace-Dh7rr7l4.mjs";
+export { CONFIG_LOAD_TIMEOUT_MS, ConfigLoadFailed, ConfigNotFound, ConfigObjectNotSerializable, NotABackendApp, NotInAnApp, WorkspaceDeclaresNoConstructs, defineConfig, defineWorkspace, findWorkspaceRoot, loadAppConfig, loadConfig, loadWorkspaceAppInfo, loadWorkspaceConfig, loadWorkspaceSettings, parseModuleConfig };

package/dist/define-CHBIEc5j.mjs

@@ -0,0 +1,94 @@
+//#region src/target/builtins.ts
+const BUILTIN_TARGETS = {
+	dokploy: {
+		runtime: "server",
+		status: "available"
+	},
+	sst: {
+		runtime: "aws",
+		status: "external",
+		instead: (stage) => `run \`gkm build && sst deploy --stage ${stage}\``
+	},
+	vercel: {
+		runtime: "aws",
+		status: "planned"
+	},
+	cloudflare: {
+		runtime: "aws",
+		status: "planned"
+	}
+};
+/** The built-in target called `name`, if one is. */
+function builtinTarget(name) {
+	return Object.hasOwn(BUILTIN_TARGETS, name) ? BUILTIN_TARGETS[name] : void 0;
+}
+/** Built-in names a config may use. */
+function configurableBuiltins() {
+	return Object.entries(BUILTIN_TARGETS).filter(([, target]) => target.status !== "planned").map(([name]) => name);
+}
+/** The `deploy.targets` entry called `name`, if the config has one. */
+function configuredTarget(deploy, name) {
+	const targets = deploy?.targets;
+	return targets && Object.hasOwn(targets, name) ? targets[name] : void 0;
+}
+/** A target name that is neither built in nor in `deploy.targets`. */
+var UnknownDeployTarget = class extends Error {
+	target;
+	known;
+	constructor(target, known) {
+		super(`Unknown deploy target "${target}". Use one of ${known.join(", ")}, or name the package that provides it in gkm.config.ts: deploy: { targets: { ${JSON.stringify(target)}: '<package>' } }.`);
+		this.target = target;
+		this.known = known;
+		this.name = "UnknownDeployTarget";
+	}
+};
+/** A built-in target `gkm deploy` cannot deploy through yet. */
+var DeployTargetNotYetSupported = class extends Error {
+	target;
+	instead;
+	constructor(target, instead) {
+		super(instead ? `gkm deploy cannot deploy through "${target}" yet: ${instead}.` : `Deploy target "${target}" is not supported yet. Deploy with dokploy, or name a target package in deploy.targets.`);
+		this.target = target;
+		this.instead = instead;
+		this.name = "DeployTargetNotYetSupported";
+	}
+};
+//#endregion
+//#region src/target/define.ts
+/**
+* A deploy target, typed from what it is written with: the options from its
+* `options` schema, the run state from what `validate` returns. Nothing
+* happens at runtime — it returns the target as given.
+*
+* ```ts
+* export default defineTarget({
+*   name: 'fly',
+*   runtime: 'server',
+*   capabilities: { rollback: true, migrations: 'target', images: true },
+*   options: z.object({ org: z.string() }),
+*   async validate(ctx) {
+*     return { org: ctx.options.org }; // ctx.options: { org: string }
+*   },
+*   async release(ctx, run) { … },       // run: { org: string }
+*   …
+* });
+* ```
+*/
+function defineTarget(target) {
+	return target;
+}
+/** Whether `value` has the shape of a target. */
+function isDeployTarget(value) {
+	if (!value || typeof value !== "object") return false;
+	const candidate = value;
+	return typeof candidate.name === "string" && (candidate.runtime === "server" || candidate.runtime === "aws") && typeof candidate.capabilities === "object" && candidate.capabilities !== null && [
+		"validate",
+		"plan",
+		"release",
+		"result"
+	].every((phase) => typeof candidate[phase] === "function");
+}
+//#endregion
+export { UnknownDeployTarget as a, configuredTarget as c, DeployTargetNotYetSupported as i, isDeployTarget as n, builtinTarget as o, BUILTIN_TARGETS as r, configurableBuiltins as s, defineTarget as t };
+
+//# sourceMappingURL=define-CHBIEc5j.mjs.map

package/dist/define-CHBIEc5j.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-CHBIEc5j.mjs","names":[],"sources":["../src/target/builtins.ts","../src/target/define.ts"],"sourcesContent":["/**\n * The target names the CLI knows without being told, and how a name is\n * looked up.\n *\n * Plain data, so the config schema and `providerOf` — which `gkm dev` and\n * `gkm build` call synchronously on every start — can ask what a name means\n * without importing a deploy engine.\n */\n\nimport type { DeployRuntime, DeployTargetEntry } from './types';\n\n/**\n * - `available`: `gkm deploy` deploys through it.\n * - `external`: a valid `deploy.default` that builds and runs locally, but is\n *   deployed by its own tool — `gkm deploy` refuses it and says which.\n * - `planned`: reserved, and refused everywhere.\n */\nexport type BuiltinStatus = 'available' | 'external' | 'planned';\n\nexport interface BuiltinTarget {\n\treadonly runtime: DeployRuntime;\n\treadonly status: BuiltinStatus;\n\t/** What to do instead, for a target `gkm deploy` cannot deploy through yet. */\n\treadonly instead?: (stage: string) => string;\n}\n\nexport const BUILTIN_TARGETS = {\n\tdokploy: { runtime: 'server', status: 'available' },\n\tsst: {\n\t\truntime: 'aws',\n\t\tstatus: 'external',\n\t\tinstead: (stage) => `run \\`gkm build && sst deploy --stage ${stage}\\``,\n\t},\n\t// Neither runs containers the project controls, so both take the managed\n\t// defaults when they arrive.\n\tvercel: { runtime: 'aws', status: 'planned' },\n\tcloudflare: { runtime: 'aws', status: 'planned' },\n} as const satisfies Record<string, BuiltinTarget>;\n\nexport type BuiltinTargetName = keyof typeof BUILTIN_TARGETS;\n\n/** The built-in target called `name`, if one is. */\nexport function builtinTarget(name: string): BuiltinTarget | undefined {\n\treturn Object.hasOwn(BUILTIN_TARGETS, name)\n\t\t? BUILTIN_TARGETS[name as BuiltinTargetName]\n\t\t: undefined;\n}\n\n/** Built-in names a config may use. */\nexport function configurableBuiltins(): string[] {\n\treturn Object.entries(BUILTIN_TARGETS)\n\t\t.filter(([, target]) => target.status !== 'planned')\n\t\t.map(([name]) => name);\n}\n\n/** The `deploy.targets` entry called `name`, if the config has one. */\nexport function configuredTarget(\n\tdeploy: { targets?: Record<string, DeployTargetEntry> } | undefined,\n\tname: string,\n): DeployTargetEntry | undefined {\n\tconst targets = deploy?.targets;\n\treturn targets && Object.hasOwn(targets, name) ? targets[name] : undefined;\n}\n\n/** A target name that is neither built in nor in `deploy.targets`. */\nexport class UnknownDeployTarget extends Error {\n\tconstructor(\n\t\treadonly target: string,\n\t\t/** The names that would have resolved. */\n\t\treadonly known: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`Unknown deploy target \"${target}\". Use one of ${known.join(', ')}, or name the package that provides it in gkm.config.ts: deploy: { targets: { ${JSON.stringify(target)}: '<package>' } }.`,\n\t\t);\n\t\tthis.name = 'UnknownDeployTarget';\n\t}\n}\n\n/** A built-in target `gkm deploy` cannot deploy through yet. */\nexport class DeployTargetNotYetSupported extends Error {\n\tconstructor(\n\t\treadonly target: string,\n\t\t/** What to do instead, when there is something. */\n\t\treadonly instead?: string,\n\t) {\n\t\tsuper(\n\t\t\tinstead\n\t\t\t\t? `gkm deploy cannot deploy through \"${target}\" yet: ${instead}.`\n\t\t\t\t: `Deploy target \"${target}\" is not supported yet. Deploy with dokploy, or name a target package in deploy.targets.`,\n\t\t);\n\t\tthis.name = 'DeployTargetNotYetSupported';\n\t}\n}\n","import type { AnyDeployTarget, DeployTarget } from './types';\n\n/**\n * A deploy target, typed from what it is written with: the options from its\n * `options` schema, the run state from what `validate` returns. Nothing\n * happens at runtime — it returns the target as given.\n *\n * ```ts\n * export default defineTarget({\n *   name: 'fly',\n *   runtime: 'server',\n *   capabilities: { rollback: true, migrations: 'target', images: true },\n *   options: z.object({ org: z.string() }),\n *   async validate(ctx) {\n *     return { org: ctx.options.org }; // ctx.options: { org: string }\n *   },\n *   async release(ctx, run) { … },       // run: { org: string }\n *   …\n * });\n * ```\n */\nexport function defineTarget<Options = undefined, Run = void>(\n\ttarget: DeployTarget<Options, Run>,\n): DeployTarget<Options, Run> {\n\treturn target;\n}\n\n/** Whether `value` has the shape of a target. */\nexport function isDeployTarget(value: unknown): value is AnyDeployTarget {\n\tif (!value || typeof value !== 'object') return false;\n\tconst candidate = value as Record<string, unknown>;\n\treturn (\n\t\ttypeof candidate.name === 'string' &&\n\t\t(candidate.runtime === 'server' || candidate.runtime === 'aws') &&\n\t\ttypeof candidate.capabilities === 'object' &&\n\t\tcandidate.capabilities !== null &&\n\t\t['validate', 'plan', 'release', 'result'].every(\n\t\t\t(phase) => typeof candidate[phase] === 'function',\n\t\t)\n\t);\n}\n"],"mappings":";AA0BA,MAAa,kBAAkB;CAC9B,SAAS;EAAE,SAAS;EAAU,QAAQ;CAAY;CAClD,KAAK;EACJ,SAAS;EACT,QAAQ;EACR,UAAU,UAAU,yCAAyC,MAAM;CACpE;CAGA,QAAQ;EAAE,SAAS;EAAO,QAAQ;CAAU;CAC5C,YAAY;EAAE,SAAS;EAAO,QAAQ;CAAU;AACjD;;AAKA,SAAgB,cAAc,MAAyC;CACtE,OAAO,OAAO,OAAO,iBAAiB,IAAI,IACvC,gBAAgB,QAChB,KAAA;AACJ;;AAGA,SAAgB,uBAAiC;CAChD,OAAO,OAAO,QAAQ,eAAe,CAAC,CACpC,QAAQ,GAAG,YAAY,OAAO,WAAW,SAAS,CAAC,CACnD,KAAK,CAAC,UAAU,IAAI;AACvB;;AAGA,SAAgB,iBACf,QACA,MACgC;CAChC,MAAM,UAAU,QAAQ;CACxB,OAAO,WAAW,OAAO,OAAO,SAAS,IAAI,IAAI,QAAQ,QAAQ,KAAA;AAClE;;AAGA,IAAa,sBAAb,cAAyC,MAAM;CAEpC;CAEA;CAHV,YACC,QAEA,OACC;EACD,MACC,0BAA0B,OAAO,gBAAgB,MAAM,KAAK,IAAI,EAAE,gFAAgF,KAAK,UAAU,MAAM,EAAE,mBAC1K;EANS,KAAA,SAAA;EAEA,KAAA,QAAA;EAKT,KAAK,OAAO;CACb;AACD;;AAGA,IAAa,8BAAb,cAAiD,MAAM;CAE5C;CAEA;CAHV,YACC,QAEA,SACC;EACD,MACC,UACG,qCAAqC,OAAO,SAAS,QAAQ,KAC7D,kBAAkB,OAAO,yFAC7B;EARS,KAAA,SAAA;EAEA,KAAA,UAAA;EAOT,KAAK,OAAO;CACb;AACD;;;;;;;;;;;;;;;;;;;;;;ACvEA,SAAgB,aACf,QAC6B;CAC7B,OAAO;AACR;;AAGA,SAAgB,eAAe,OAA0C;CACxE,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU,OAAO;CAChD,MAAM,YAAY;CAClB,OACC,OAAO,UAAU,SAAS,aACzB,UAAU,YAAY,YAAY,UAAU,YAAY,UACzD,OAAO,UAAU,iBAAiB,YAClC,UAAU,iBAAiB,QAC3B;EAAC;EAAY;EAAQ;EAAW;CAAQ,CAAC,CAAC,OACxC,UAAU,OAAO,UAAU,WAAW,UACxC;AAEF"}