@geekmidas/cli 10.0.0-alpha.62 → 10.0.0-alpha.64

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-DIA7Li-J.cjs";
-import { i as defineWorkspace } from "./index-BtXDZQuF.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-DkrDOMxw.cjs";
+import { i as defineWorkspace } from "./index-CfE9Y885.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-Be-4_I6H.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-CfLKGfC_.mjs";
-import { i as defineWorkspace } from "./index-DrKzpHl-.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-B_bEQvb9.mjs";
+import { i as defineWorkspace } from "./index-CJ2qsSpp.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-DqNRiQOp.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 };