@ankhorage/infra 0.2.1 → 0.3.1

package/dist/infraValidation.js

@@ -0,0 +1,58 @@
+import { AUTH_PROVIDERS, AUTH_SCOPES, AUTHZ_ENGINES, DATABASE_PROVIDERS, DEPLOYMENT_TARGETS, } from '@ankhorage/contracts';
+export function validateInfraSupport(manifest) {
+    const warnings = [];
+    const deploymentTarget = manifest.deployment?.target;
+    if (deploymentTarget !== undefined && !isSupported(deploymentTarget, DEPLOYMENT_TARGETS)) {
+        warnings.push(warningForUnsupportedValue({
+            path: 'infra.deployment.target',
+            value: deploymentTarget,
+            supported: DEPLOYMENT_TARGETS,
+        }));
+    }
+    const databaseProvider = manifest.database?.provider;
+    if (databaseProvider !== undefined && !isSupported(databaseProvider, DATABASE_PROVIDERS)) {
+        warnings.push(warningForUnsupportedValue({
+            path: 'infra.database.provider',
+            value: databaseProvider,
+            supported: DATABASE_PROVIDERS,
+        }));
+    }
+    const authProvider = manifest.auth?.provider;
+    if (authProvider !== undefined && !isSupported(authProvider, AUTH_PROVIDERS)) {
+        warnings.push(warningForUnsupportedValue({
+            path: 'infra.auth.provider',
+            value: authProvider,
+            supported: AUTH_PROVIDERS,
+        }));
+    }
+    const authScope = manifest.auth?.scope;
+    if (authScope !== undefined && !isSupported(authScope, AUTH_SCOPES)) {
+        warnings.push(warningForUnsupportedValue({
+            path: 'infra.auth.scope',
+            value: authScope,
+            supported: AUTH_SCOPES,
+        }));
+    }
+    const authzEngine = manifest.auth?.authorization.engine;
+    if (authzEngine !== undefined && !isSupported(authzEngine, AUTHZ_ENGINES)) {
+        warnings.push(warningForUnsupportedValue({
+            path: 'infra.auth.authorization.engine',
+            value: authzEngine,
+            supported: AUTHZ_ENGINES,
+        }));
+    }
+    return warnings;
+}
+function warningForUnsupportedValue(args) {
+    return `${args.path} "${args.value}" is not currently supported by implemented generators. Supported values: ${formatSupportedValues(args.supported)}.`;
+}
+function formatSupportedValues(values) {
+    if (values.length === 0) {
+        return '(none)';
+    }
+    return values.join(', ');
+}
+function isSupported(value, supported) {
+    return supported.includes(value);
+}
+//# sourceMappingURL=infraValidation.js.map

package/dist/infraValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infraValidation.js","sourceRoot":"","sources":["../src/infraValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,UAAU,oBAAoB,CAAC,QAA4B;IAC/D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACrD,IAAI,gBAAgB,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACzF,QAAQ,CAAC,IAAI,CACX,0BAA0B,CAAC;YACzB,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,gBAAgB;YACvB,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACrD,IAAI,gBAAgB,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACzF,QAAQ,CAAC,IAAI,CACX,0BAA0B,CAAC;YACzB,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,gBAAgB;YACvB,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC7C,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,CAAC;QAC7E,QAAQ,CAAC,IAAI,CACX,0BAA0B,CAAC;YACzB,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,cAAc;SAC1B,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACvC,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC;QACpE,QAAQ,CAAC,IAAI,CACX,0BAA0B,CAAC;YACzB,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,WAAW;SACvB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;IACxD,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,CAAC;QAC1E,QAAQ,CAAC,IAAI,CACX,0BAA0B,CAAC;YACzB,IAAI,EAAE,iCAAiC;YACvC,KAAK,EAAE,WAAW;YAClB,SAAS,EAAE,aAAa;SACzB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,0BAA0B,CAAC,IAInC;IACC,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,6EAA6E,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;AAC1J,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAyB;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,SAA4B;IAC9D,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import {\n  AUTH_PROVIDERS,\n  AUTH_SCOPES,\n  AUTHZ_ENGINES,\n  DATABASE_PROVIDERS,\n  DEPLOYMENT_TARGETS,\n} from '@ankhorage/contracts';\n\nimport type { InfraManifestInput } from './types.js';\n\nexport function validateInfraSupport(manifest: InfraManifestInput): readonly string[] {\n  const warnings: string[] = [];\n\n  const deploymentTarget = manifest.deployment?.target;\n  if (deploymentTarget !== undefined && !isSupported(deploymentTarget, DEPLOYMENT_TARGETS)) {\n    warnings.push(\n      warningForUnsupportedValue({\n        path: 'infra.deployment.target',\n        value: deploymentTarget,\n        supported: DEPLOYMENT_TARGETS,\n      }),\n    );\n  }\n\n  const databaseProvider = manifest.database?.provider;\n  if (databaseProvider !== undefined && !isSupported(databaseProvider, DATABASE_PROVIDERS)) {\n    warnings.push(\n      warningForUnsupportedValue({\n        path: 'infra.database.provider',\n        value: databaseProvider,\n        supported: DATABASE_PROVIDERS,\n      }),\n    );\n  }\n\n  const authProvider = manifest.auth?.provider;\n  if (authProvider !== undefined && !isSupported(authProvider, AUTH_PROVIDERS)) {\n    warnings.push(\n      warningForUnsupportedValue({\n        path: 'infra.auth.provider',\n        value: authProvider,\n        supported: AUTH_PROVIDERS,\n      }),\n    );\n  }\n\n  const authScope = manifest.auth?.scope;\n  if (authScope !== undefined && !isSupported(authScope, AUTH_SCOPES)) {\n    warnings.push(\n      warningForUnsupportedValue({\n        path: 'infra.auth.scope',\n        value: authScope,\n        supported: AUTH_SCOPES,\n      }),\n    );\n  }\n\n  const authzEngine = manifest.auth?.authorization.engine;\n  if (authzEngine !== undefined && !isSupported(authzEngine, AUTHZ_ENGINES)) {\n    warnings.push(\n      warningForUnsupportedValue({\n        path: 'infra.auth.authorization.engine',\n        value: authzEngine,\n        supported: AUTHZ_ENGINES,\n      }),\n    );\n  }\n\n  return warnings;\n}\n\nfunction warningForUnsupportedValue(args: {\n  readonly path: string;\n  readonly value: string;\n  readonly supported: readonly string[];\n}): string {\n  return `${args.path} \"${args.value}\" is not currently supported by implemented generators. Supported values: ${formatSupportedValues(args.supported)}.`;\n}\n\nfunction formatSupportedValues(values: readonly string[]): string {\n  if (values.length === 0) {\n    return '(none)';\n  }\n\n  return values.join(', ');\n}\n\nfunction isSupported(value: string, supported: readonly string[]): boolean {\n  return supported.includes(value);\n}\n"]}

package/dist/metadata/index.d.ts

@@ -0,0 +1,2 @@
+export { INFRA_CAPABILITIES, INFRA_COMMAND_CATEGORY, INFRA_PACKAGE_METADATA, INFRA_PACKAGE_NAME, INFRA_PACKAGE_VERSION, } from '../packageMetadata.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/metadata/index.js

@@ -0,0 +1,2 @@
+export { INFRA_CAPABILITIES, INFRA_COMMAND_CATEGORY, INFRA_PACKAGE_METADATA, INFRA_PACKAGE_NAME, INFRA_PACKAGE_VERSION, } from '../packageMetadata.js';
+//# sourceMappingURL=index.js.map

package/dist/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC","sourcesContent":["export {\n  INFRA_CAPABILITIES,\n  INFRA_COMMAND_CATEGORY,\n  INFRA_PACKAGE_METADATA,\n  INFRA_PACKAGE_NAME,\n  INFRA_PACKAGE_VERSION,\n} from '../packageMetadata.js';\n"]}

package/dist/packageMetadata.d.ts

@@ -0,0 +1,10 @@
+export declare const INFRA_PACKAGE_NAME: string;
+export declare const INFRA_PACKAGE_VERSION: string;
+export declare const INFRA_COMMAND_CATEGORY: "infra";
+export declare const INFRA_CAPABILITIES: readonly ["infra.validate", "infra.generate", "infra.status", "infra.up", "infra.down"];
+export declare const INFRA_PACKAGE_METADATA: {
+    readonly category: "infra";
+    readonly provider: "./dist/ankh.provider.js";
+    readonly capabilities: readonly ["infra.validate", "infra.generate", "infra.status", "infra.up", "infra.down"];
+};
+//# sourceMappingURL=packageMetadata.d.ts.map

package/dist/packageMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageMetadata.d.ts","sourceRoot":"","sources":["../src/packageMetadata.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AACnD,eAAO,MAAM,qBAAqB,QAAsB,CAAC;AACzD,eAAO,MAAM,sBAAsB,SAAiD,CAAC;AACrF,eAAO,MAAM,kBAAkB,yFAMiB,CAAC;AAEjD,eAAO,MAAM,sBAAsB;;;;CAIK,CAAC"}

package/dist/packageMetadata.js

@@ -0,0 +1,17 @@
+import packageJson from '../package.json';
+export const INFRA_PACKAGE_NAME = packageJson.name;
+export const INFRA_PACKAGE_VERSION = packageJson.version;
+export const INFRA_COMMAND_CATEGORY = 'infra';
+export const INFRA_CAPABILITIES = [
+    'infra.validate',
+    'infra.generate',
+    'infra.status',
+    'infra.up',
+    'infra.down',
+];
+export const INFRA_PACKAGE_METADATA = {
+    category: INFRA_COMMAND_CATEGORY,
+    provider: './dist/ankh.provider.js',
+    capabilities: INFRA_CAPABILITIES,
+};
+//# sourceMappingURL=packageMetadata.js.map

package/dist/packageMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageMetadata.js","sourceRoot":"","sources":["../src/packageMetadata.ts"],"names":[],"mappings":"AAMA,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAE1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC,IAAI,CAAC;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,CAAC;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAA8C,CAAC;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,UAAU;IACV,YAAY;CACkC,CAAC;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,sBAAsB;IAChC,QAAQ,EAAE,yBAAyB;IACnC,YAAY,EAAE,kBAAkB;CACM,CAAC","sourcesContent":["import type {\n  AnkhCapabilityId,\n  AnkhCommandCategory,\n  AnkhPackageMetadata,\n} from '@ankhorage/contracts/cli';\n\nimport packageJson from '../package.json';\n\nexport const INFRA_PACKAGE_NAME = packageJson.name;\nexport const INFRA_PACKAGE_VERSION = packageJson.version;\nexport const INFRA_COMMAND_CATEGORY = 'infra' as const satisfies AnkhCommandCategory;\nexport const INFRA_CAPABILITIES = [\n  'infra.validate',\n  'infra.generate',\n  'infra.status',\n  'infra.up',\n  'infra.down',\n] as const satisfies readonly AnkhCapabilityId[];\n\nexport const INFRA_PACKAGE_METADATA = {\n  category: INFRA_COMMAND_CATEGORY,\n  provider: './dist/ankh.provider.js',\n  capabilities: INFRA_CAPABILITIES,\n} as const satisfies AnkhPackageMetadata;\n"]}

package/dist/project.d.ts

@@ -0,0 +1,14 @@
+import type { AppManifest } from '@ankhorage/contracts';
+export interface ResolvedInfraProject {
+    readonly appsRoot: string;
+    readonly manifest: AppManifest;
+    readonly manifestPath: string;
+    readonly projectId: string;
+    readonly projectPath: string;
+    readonly workspaceRoot: string;
+}
+export declare function resolveInfraProject(options: {
+    readonly cwd: string;
+    readonly projectId?: string;
+}): Promise<ResolvedInfraProject>;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAiC,MAAM,sBAAsB,CAAC;AAIvF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqChC"}

package/dist/project.js

@@ -0,0 +1,202 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+export async function resolveInfraProject(options) {
+    const workspaceRoot = await findWorkspaceRoot(options.cwd);
+    if (workspaceRoot === null) {
+        throw new Error(`Could not find an Ankh workspace root from cwd: ${options.cwd}`);
+    }
+    const appsRoot = path.join(workspaceRoot, 'apps');
+    const projectId = options.projectId === undefined
+        ? inferProjectId(options.cwd, appsRoot)
+        : validateExplicitProjectId(options.projectId);
+    if (projectId === null) {
+        throw new Error('Could not infer a project from cwd. Pass a project id or run the command inside apps/<project>.');
+    }
+    const projectPath = resolveProjectPath(appsRoot, projectId);
+    if (!(await pathExists(projectPath))) {
+        throw new Error(`Project '${projectId}' not found.`);
+    }
+    const manifestPath = path.join(projectPath, 'ankh.config.json');
+    const manifest = await readProjectManifest({
+        manifestPath,
+        projectId,
+        projectPath,
+    });
+    return {
+        appsRoot,
+        manifest,
+        manifestPath,
+        projectId,
+        projectPath,
+        workspaceRoot,
+    };
+}
+function resolveProjectPath(appsRoot, projectId) {
+    const projectPath = path.resolve(appsRoot, projectId);
+    const appsRootPath = `${path.resolve(appsRoot)}${path.sep}`;
+    if (!projectPath.startsWith(appsRootPath)) {
+        throw new Error('Security check failed while resolving the project path.');
+    }
+    return projectPath;
+}
+function createFallbackManifest(projectId) {
+    return {
+        metadata: {
+            name: projectId,
+            slug: projectId,
+            version: '0.0.0',
+            themeId: 'default',
+        },
+        themes: [],
+        activeThemeId: 'default',
+        infra: {
+            plugins: [],
+        },
+        navigator: {
+            type: 'stack',
+            routes: [{ name: 'index', screenId: 'index' }],
+        },
+        screens: {},
+        settings: {
+            localization: {
+                defaultLocale: 'en',
+                locales: ['en'],
+            },
+            authFlow: {
+                signInRoute: '/sign-in',
+                signOutRoute: '/sign-out',
+                postSignInRoute: '/',
+                unauthorizedRoute: '/sign-in',
+            },
+        },
+    };
+}
+async function readProjectManifest(args) {
+    if (!(await pathExists(args.manifestPath))) {
+        return createFallbackManifest(args.projectId);
+    }
+    const rawManifest = await fs.readFile(args.manifestPath, 'utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(rawManifest);
+    }
+    catch (error) {
+        throw new Error(`Project manifest is not valid JSON: ${args.manifestPath}: ${getErrorMessage(error)}`, { cause: error });
+    }
+    if (!isAppManifest(parsed)) {
+        throw new Error(`Project manifest has an invalid shape: ${args.manifestPath}`);
+    }
+    return parsed;
+}
+async function findWorkspaceRoot(startPath) {
+    let currentPath = path.resolve(startPath);
+    for (;;) {
+        const appsRoot = path.join(currentPath, 'apps');
+        if (await isDirectory(appsRoot)) {
+            return currentPath;
+        }
+        const parentPath = path.dirname(currentPath);
+        if (parentPath === currentPath) {
+            return null;
+        }
+        currentPath = parentPath;
+    }
+}
+function inferProjectId(cwd, appsRoot) {
+    const relativePath = path.relative(path.resolve(appsRoot), path.resolve(cwd));
+    if (relativePath === '' || relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
+        return null;
+    }
+    const [projectId] = relativePath.split(path.sep);
+    return projectId === undefined || projectId.length === 0 ? null : path.basename(projectId);
+}
+function validateExplicitProjectId(projectId) {
+    if (projectId.trim().length === 0) {
+        throw new Error('Invalid project id: expected a single safe project segment.');
+    }
+    if (projectId === '.' ||
+        projectId === '..' ||
+        path.isAbsolute(projectId) ||
+        projectId.includes('/') ||
+        projectId.includes('\\')) {
+        throw new Error(`Invalid project id: ${projectId}. Expected a single safe project segment.`);
+    }
+    return projectId;
+}
+function isAppManifest(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return (isAppManifestMetadata(value.metadata) &&
+        Array.isArray(value.themes) &&
+        typeof value.activeThemeId === 'string' &&
+        isInfraManifestRecord(value.infra) &&
+        isNavigatorSpec(value.navigator) &&
+        isRecord(value.screens) &&
+        isSettingsRecord(value.settings));
+}
+function isAppManifestMetadata(value) {
+    return (isRecord(value) &&
+        typeof value.name === 'string' &&
+        typeof value.slug === 'string' &&
+        typeof value.version === 'string' &&
+        typeof value.themeId === 'string' &&
+        (value.created === undefined || typeof value.created === 'string') &&
+        (value.updated === undefined || typeof value.updated === 'string'));
+}
+function isInfraManifestRecord(value) {
+    return isRecord(value) && Array.isArray(value.plugins);
+}
+function isNavigatorSpec(value) {
+    return (isRecord(value) &&
+        typeof value.type === 'string' &&
+        Array.isArray(value.routes) &&
+        (value.initialRouteName === undefined || typeof value.initialRouteName === 'string'));
+}
+function isSettingsRecord(value) {
+    return (isRecord(value) &&
+        (value.apiBaseUrl === undefined || typeof value.apiBaseUrl === 'string') &&
+        isLocalizationRecord(value.localization) &&
+        isAuthFlowConfig(value.authFlow));
+}
+function isLocalizationRecord(value) {
+    return (isRecord(value) &&
+        typeof value.defaultLocale === 'string' &&
+        Array.isArray(value.locales) &&
+        value.locales.every((locale) => typeof locale === 'string'));
+}
+function isAuthFlowConfig(value) {
+    return (isRecord(value) &&
+        typeof value.signInRoute === 'string' &&
+        typeof value.postSignInRoute === 'string' &&
+        (value.signUpRoute === undefined || typeof value.signUpRoute === 'string') &&
+        (value.signOutRoute === undefined || typeof value.signOutRoute === 'string') &&
+        (value.forgotPasswordRoute === undefined || typeof value.forgotPasswordRoute === 'string') &&
+        (value.otpRoute === undefined || typeof value.otpRoute === 'string') &&
+        (value.unauthorizedRoute === undefined || typeof value.unauthorizedRoute === 'string'));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+async function isDirectory(filePath) {
+    try {
+        const stat = await fs.stat(filePath);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function pathExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AppManifest, AuthFlowConfig, NavigatorSpec } from '@ankhorage/contracts';\nimport { promises as fs } from 'fs';\nimport path from 'path';\n\nexport interface ResolvedInfraProject {\n  readonly appsRoot: string;\n  readonly manifest: AppManifest;\n  readonly manifestPath: string;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly workspaceRoot: string;\n}\n\nexport async function resolveInfraProject(options: {\n  readonly cwd: string;\n  readonly projectId?: string;\n}): Promise<ResolvedInfraProject> {\n  const workspaceRoot = await findWorkspaceRoot(options.cwd);\n  if (workspaceRoot === null) {\n    throw new Error(`Could not find an Ankh workspace root from cwd: ${options.cwd}`);\n  }\n\n  const appsRoot = path.join(workspaceRoot, 'apps');\n  const projectId =\n    options.projectId === undefined\n      ? inferProjectId(options.cwd, appsRoot)\n      : validateExplicitProjectId(options.projectId);\n  if (projectId === null) {\n    throw new Error(\n      'Could not infer a project from cwd. Pass a project id or run the command inside apps/<project>.',\n    );\n  }\n\n  const projectPath = resolveProjectPath(appsRoot, projectId);\n  if (!(await pathExists(projectPath))) {\n    throw new Error(`Project '${projectId}' not found.`);\n  }\n\n  const manifestPath = path.join(projectPath, 'ankh.config.json');\n  const manifest = await readProjectManifest({\n    manifestPath,\n    projectId,\n    projectPath,\n  });\n\n  return {\n    appsRoot,\n    manifest,\n    manifestPath,\n    projectId,\n    projectPath,\n    workspaceRoot,\n  };\n}\n\nfunction resolveProjectPath(appsRoot: string, projectId: string): string {\n  const projectPath = path.resolve(appsRoot, projectId);\n  const appsRootPath = `${path.resolve(appsRoot)}${path.sep}`;\n\n  if (!projectPath.startsWith(appsRootPath)) {\n    throw new Error('Security check failed while resolving the project path.');\n  }\n\n  return projectPath;\n}\n\nfunction createFallbackManifest(projectId: string): AppManifest {\n  return {\n    metadata: {\n      name: projectId,\n      slug: projectId,\n      version: '0.0.0',\n      themeId: 'default',\n    },\n    themes: [],\n    activeThemeId: 'default',\n    infra: {\n      plugins: [],\n    },\n    navigator: {\n      type: 'stack',\n      routes: [{ name: 'index', screenId: 'index' }],\n    },\n    screens: {},\n    settings: {\n      localization: {\n        defaultLocale: 'en',\n        locales: ['en'],\n      },\n      authFlow: {\n        signInRoute: '/sign-in',\n        signOutRoute: '/sign-out',\n        postSignInRoute: '/',\n        unauthorizedRoute: '/sign-in',\n      },\n    },\n  };\n}\n\nasync function readProjectManifest(args: {\n  readonly manifestPath: string;\n  readonly projectId: string;\n  readonly projectPath: string;\n}): Promise<AppManifest> {\n  if (!(await pathExists(args.manifestPath))) {\n    return createFallbackManifest(args.projectId);\n  }\n\n  const rawManifest = await fs.readFile(args.manifestPath, 'utf8');\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(rawManifest);\n  } catch (error) {\n    throw new Error(\n      `Project manifest is not valid JSON: ${args.manifestPath}: ${getErrorMessage(error)}`,\n      { cause: error },\n    );\n  }\n\n  if (!isAppManifest(parsed)) {\n    throw new Error(`Project manifest has an invalid shape: ${args.manifestPath}`);\n  }\n\n  return parsed;\n}\n\nasync function findWorkspaceRoot(startPath: string): Promise<string | null> {\n  let currentPath = path.resolve(startPath);\n\n  for (;;) {\n    const appsRoot = path.join(currentPath, 'apps');\n    if (await isDirectory(appsRoot)) {\n      return currentPath;\n    }\n\n    const parentPath = path.dirname(currentPath);\n    if (parentPath === currentPath) {\n      return null;\n    }\n\n    currentPath = parentPath;\n  }\n}\n\nfunction inferProjectId(cwd: string, appsRoot: string): string | null {\n  const relativePath = path.relative(path.resolve(appsRoot), path.resolve(cwd));\n  if (relativePath === '' || relativePath.startsWith('..') || path.isAbsolute(relativePath)) {\n    return null;\n  }\n\n  const [projectId] = relativePath.split(path.sep);\n  return projectId === undefined || projectId.length === 0 ? null : path.basename(projectId);\n}\n\nfunction validateExplicitProjectId(projectId: string): string {\n  if (projectId.trim().length === 0) {\n    throw new Error('Invalid project id: expected a single safe project segment.');\n  }\n\n  if (\n    projectId === '.' ||\n    projectId === '..' ||\n    path.isAbsolute(projectId) ||\n    projectId.includes('/') ||\n    projectId.includes('\\\\')\n  ) {\n    throw new Error(`Invalid project id: ${projectId}. Expected a single safe project segment.`);\n  }\n\n  return projectId;\n}\n\nfunction isAppManifest(value: unknown): value is AppManifest {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return (\n    isAppManifestMetadata(value.metadata) &&\n    Array.isArray(value.themes) &&\n    typeof value.activeThemeId === 'string' &&\n    isInfraManifestRecord(value.infra) &&\n    isNavigatorSpec(value.navigator) &&\n    isRecord(value.screens) &&\n    isSettingsRecord(value.settings)\n  );\n}\n\nfunction isAppManifestMetadata(value: unknown): value is AppManifest['metadata'] {\n  return (\n    isRecord(value) &&\n    typeof value.name === 'string' &&\n    typeof value.slug === 'string' &&\n    typeof value.version === 'string' &&\n    typeof value.themeId === 'string' &&\n    (value.created === undefined || typeof value.created === 'string') &&\n    (value.updated === undefined || typeof value.updated === 'string')\n  );\n}\n\nfunction isInfraManifestRecord(value: unknown): value is AppManifest['infra'] {\n  return isRecord(value) && Array.isArray(value.plugins);\n}\n\nfunction isNavigatorSpec(value: unknown): value is NavigatorSpec {\n  return (\n    isRecord(value) &&\n    typeof value.type === 'string' &&\n    Array.isArray(value.routes) &&\n    (value.initialRouteName === undefined || typeof value.initialRouteName === 'string')\n  );\n}\n\nfunction isSettingsRecord(value: unknown): value is AppManifest['settings'] {\n  return (\n    isRecord(value) &&\n    (value.apiBaseUrl === undefined || typeof value.apiBaseUrl === 'string') &&\n    isLocalizationRecord(value.localization) &&\n    isAuthFlowConfig(value.authFlow)\n  );\n}\n\nfunction isLocalizationRecord(value: unknown): value is AppManifest['settings']['localization'] {\n  return (\n    isRecord(value) &&\n    typeof value.defaultLocale === 'string' &&\n    Array.isArray(value.locales) &&\n    value.locales.every((locale) => typeof locale === 'string')\n  );\n}\n\nfunction isAuthFlowConfig(value: unknown): value is AuthFlowConfig {\n  return (\n    isRecord(value) &&\n    typeof value.signInRoute === 'string' &&\n    typeof value.postSignInRoute === 'string' &&\n    (value.signUpRoute === undefined || typeof value.signUpRoute === 'string') &&\n    (value.signOutRoute === undefined || typeof value.signOutRoute === 'string') &&\n    (value.forgotPasswordRoute === undefined || typeof value.forgotPasswordRoute === 'string') &&\n    (value.otpRoute === undefined || typeof value.otpRoute === 'string') &&\n    (value.unauthorizedRoute === undefined || typeof value.unauthorizedRoute === 'string')\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nasync function isDirectory(filePath: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(filePath);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nasync function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await fs.access(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction getErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}

package/dist/projectInfrastructure.d.ts

@@ -0,0 +1,22 @@
+import type { AppManifest } from '@ankhorage/contracts';
+import { generateInfrastructure } from './index.js';
+export interface InfraSyncResult {
+    readonly generated: number;
+    readonly removed: number;
+    readonly warnings: readonly string[];
+    readonly skipped?: {
+        readonly reason: string;
+    };
+}
+export declare function syncProjectInfrastructure(args: {
+    readonly generateInfrastructureImpl?: typeof generateInfrastructure;
+    readonly manifest: AppManifest;
+    readonly projectId: string;
+    readonly projectPath: string;
+}): Promise<InfraSyncResult>;
+export declare function resolveProjectInfrastructureTarget(args: {
+    readonly manifest: AppManifest;
+    readonly projectPath: string;
+}): Promise<string | null>;
+export declare function resolveProjectFile(projectPath: string, filePath: string): string;
+//# sourceMappingURL=projectInfrastructure.d.ts.map

package/dist/projectInfrastructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectInfrastructure.d.ts","sourceRoot":"","sources":["../src/projectInfrastructure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAcpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,sBAAsB,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAAC,eAAe,CAAC,CAiE3B;AAED,wBAAsB,kCAAkC,CAAC,IAAI,EAAE;IAC7D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQzB;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUhF"}

package/dist/projectInfrastructure.js

@@ -0,0 +1,120 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { generateInfrastructure } from './index.js';
+import { validateInfraSupport } from './infraValidation.js';
+const INFRA_LEDGER_RELATIVE_PATH = '.ankh/infra-ledger.json';
+const STUDIO_PROJECT_ID = 'studio';
+export async function syncProjectInfrastructure(args) {
+    const supportWarnings = validateInfraSupport(args.manifest.infra);
+    if (args.projectId === STUDIO_PROJECT_ID) {
+        return {
+            generated: 0,
+            removed: 0,
+            warnings: supportWarnings,
+            skipped: {
+                reason: 'apps/studio is the dashboard and is not a generated app target.',
+            },
+        };
+    }
+    const previousLedger = await readInfraLedger(args.projectPath);
+    const previousFiles = new Set(previousLedger?.files ?? []);
+    if (args.manifest.infra.deployment === undefined) {
+        const removed = await removeFiles(args.projectPath, previousFiles);
+        await removeInfraLedger(args.projectPath);
+        return {
+            generated: 0,
+            removed,
+            warnings: supportWarnings,
+        };
+    }
+    const generated = (args.generateInfrastructureImpl ?? generateInfrastructure)(args.manifest.infra, {
+        namespaceHint: args.projectId,
+        appManifest: args.manifest,
+    });
+    const combinedWarnings = uniqueStrings([...supportWarnings, ...generated.warnings]);
+    const nextFiles = new Set();
+    for (const file of generated.files) {
+        const outputPath = resolveProjectFile(args.projectPath, file.path);
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+        await fs.writeFile(outputPath, file.content, 'utf8');
+        if (file.executable === true) {
+            await fs.chmod(outputPath, 0o755);
+        }
+        nextFiles.add(file.path);
+    }
+    const staleFiles = new Set([...previousFiles].filter((filePath) => !nextFiles.has(filePath)));
+    const removed = await removeFiles(args.projectPath, staleFiles);
+    await writeInfraLedger(args.projectPath, {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        target: generated.meta.target,
+        files: [...nextFiles].sort(),
+        warnings: combinedWarnings,
+    });
+    return {
+        generated: generated.files.length,
+        removed,
+        warnings: combinedWarnings,
+    };
+}
+export async function resolveProjectInfrastructureTarget(args) {
+    const manifestTarget = args.manifest.infra.deployment?.target;
+    if (manifestTarget !== undefined) {
+        return manifestTarget;
+    }
+    const ledger = await readInfraLedger(args.projectPath);
+    return ledger?.target ?? null;
+}
+export function resolveProjectFile(projectPath, filePath) {
+    const rootPath = path.resolve(projectPath);
+    const resolvedPath = path.resolve(rootPath, filePath);
+    const relativePath = path.relative(rootPath, resolvedPath);
+    if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
+        throw new Error(`Invalid infra output path outside project root: ${filePath}`);
+    }
+    return resolvedPath;
+}
+async function readInfraLedger(projectPath) {
+    const ledgerPath = path.join(projectPath, INFRA_LEDGER_RELATIVE_PATH);
+    try {
+        const rawLedger = await fs.readFile(ledgerPath, 'utf8');
+        const parsedLedger = JSON.parse(rawLedger);
+        return isInfraLedger(parsedLedger) ? parsedLedger : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeInfraLedger(projectPath, ledger) {
+    const ledgerPath = path.join(projectPath, INFRA_LEDGER_RELATIVE_PATH);
+    await fs.mkdir(path.dirname(ledgerPath), { recursive: true });
+    await fs.writeFile(ledgerPath, `${JSON.stringify(ledger, null, 2)}\n`, 'utf8');
+}
+async function removeInfraLedger(projectPath) {
+    await fs.rm(path.join(projectPath, INFRA_LEDGER_RELATIVE_PATH), { force: true });
+}
+async function removeFiles(projectPath, files) {
+    let removedFiles = 0;
+    for (const filePath of files) {
+        await fs.rm(resolveProjectFile(projectPath, filePath), { force: true });
+        removedFiles += 1;
+    }
+    return removedFiles;
+}
+function isInfraLedger(value) {
+    return (isRecord(value) &&
+        value.schemaVersion === 1 &&
+        typeof value.generatedAt === 'string' &&
+        typeof value.target === 'string' &&
+        Array.isArray(value.files) &&
+        value.files.every((filePath) => typeof filePath === 'string') &&
+        Array.isArray(value.warnings) &&
+        value.warnings.every((warning) => typeof warning === 'string'));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function uniqueStrings(values) {
+    return [...new Set(values)];
+}
+//# sourceMappingURL=projectInfrastructure.js.map

package/dist/projectInfrastructure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectInfrastructure.js","sourceRoot":"","sources":["../src/projectInfrastructure.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AppManifest } from '@ankhorage/contracts';\nimport { promises as fs } from 'fs';\nimport path from 'path';\n\nimport { generateInfrastructure } from './index.js';\nimport { validateInfraSupport } from './infraValidation.js';\n\nconst INFRA_LEDGER_RELATIVE_PATH = '.ankh/infra-ledger.json';\nconst STUDIO_PROJECT_ID = 'studio';\n\ninterface InfraLedger {\n  readonly schemaVersion: 1;\n  readonly generatedAt: string;\n  readonly target: string;\n  readonly files: readonly string[];\n  readonly warnings: readonly string[];\n}\n\nexport interface InfraSyncResult {\n  readonly generated: number;\n  readonly removed: number;\n  readonly warnings: readonly string[];\n  readonly skipped?: {\n    readonly reason: string;\n  };\n}\n\nexport async function syncProjectInfrastructure(args: {\n  readonly generateInfrastructureImpl?: typeof generateInfrastructure;\n  readonly manifest: AppManifest;\n  readonly projectId: string;\n  readonly projectPath: string;\n}): Promise<InfraSyncResult> {\n  const supportWarnings = validateInfraSupport(args.manifest.infra);\n\n  if (args.projectId === STUDIO_PROJECT_ID) {\n    return {\n      generated: 0,\n      removed: 0,\n      warnings: supportWarnings,\n      skipped: {\n        reason: 'apps/studio is the dashboard and is not a generated app target.',\n      },\n    };\n  }\n\n  const previousLedger = await readInfraLedger(args.projectPath);\n  const previousFiles = new Set(previousLedger?.files ?? []);\n\n  if (args.manifest.infra.deployment === undefined) {\n    const removed = await removeFiles(args.projectPath, previousFiles);\n    await removeInfraLedger(args.projectPath);\n    return {\n      generated: 0,\n      removed,\n      warnings: supportWarnings,\n    };\n  }\n\n  const generated = (args.generateInfrastructureImpl ?? generateInfrastructure)(\n    args.manifest.infra,\n    {\n      namespaceHint: args.projectId,\n      appManifest: args.manifest,\n    },\n  );\n  const combinedWarnings = uniqueStrings([...supportWarnings, ...generated.warnings]);\n  const nextFiles = new Set<string>();\n\n  for (const file of generated.files) {\n    const outputPath = resolveProjectFile(args.projectPath, file.path);\n    await fs.mkdir(path.dirname(outputPath), { recursive: true });\n    await fs.writeFile(outputPath, file.content, 'utf8');\n\n    if (file.executable === true) {\n      await fs.chmod(outputPath, 0o755);\n    }\n\n    nextFiles.add(file.path);\n  }\n\n  const staleFiles = new Set([...previousFiles].filter((filePath) => !nextFiles.has(filePath)));\n  const removed = await removeFiles(args.projectPath, staleFiles);\n\n  await writeInfraLedger(args.projectPath, {\n    schemaVersion: 1,\n    generatedAt: new Date().toISOString(),\n    target: generated.meta.target,\n    files: [...nextFiles].sort(),\n    warnings: combinedWarnings,\n  });\n\n  return {\n    generated: generated.files.length,\n    removed,\n    warnings: combinedWarnings,\n  };\n}\n\nexport async function resolveProjectInfrastructureTarget(args: {\n  readonly manifest: AppManifest;\n  readonly projectPath: string;\n}): Promise<string | null> {\n  const manifestTarget = args.manifest.infra.deployment?.target;\n  if (manifestTarget !== undefined) {\n    return manifestTarget;\n  }\n\n  const ledger = await readInfraLedger(args.projectPath);\n  return ledger?.target ?? null;\n}\n\nexport function resolveProjectFile(projectPath: string, filePath: string): string {\n  const rootPath = path.resolve(projectPath);\n  const resolvedPath = path.resolve(rootPath, filePath);\n  const relativePath = path.relative(rootPath, resolvedPath);\n\n  if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {\n    throw new Error(`Invalid infra output path outside project root: ${filePath}`);\n  }\n\n  return resolvedPath;\n}\n\nasync function readInfraLedger(projectPath: string): Promise<InfraLedger | null> {\n  const ledgerPath = path.join(projectPath, INFRA_LEDGER_RELATIVE_PATH);\n\n  try {\n    const rawLedger = await fs.readFile(ledgerPath, 'utf8');\n    const parsedLedger: unknown = JSON.parse(rawLedger);\n    return isInfraLedger(parsedLedger) ? parsedLedger : null;\n  } catch {\n    return null;\n  }\n}\n\nasync function writeInfraLedger(projectPath: string, ledger: InfraLedger): Promise<void> {\n  const ledgerPath = path.join(projectPath, INFRA_LEDGER_RELATIVE_PATH);\n  await fs.mkdir(path.dirname(ledgerPath), { recursive: true });\n  await fs.writeFile(ledgerPath, `${JSON.stringify(ledger, null, 2)}\\n`, 'utf8');\n}\n\nasync function removeInfraLedger(projectPath: string): Promise<void> {\n  await fs.rm(path.join(projectPath, INFRA_LEDGER_RELATIVE_PATH), { force: true });\n}\n\nasync function removeFiles(projectPath: string, files: ReadonlySet<string>): Promise<number> {\n  let removedFiles = 0;\n\n  for (const filePath of files) {\n    await fs.rm(resolveProjectFile(projectPath, filePath), { force: true });\n    removedFiles += 1;\n  }\n\n  return removedFiles;\n}\n\nfunction isInfraLedger(value: unknown): value is InfraLedger {\n  return (\n    isRecord(value) &&\n    value.schemaVersion === 1 &&\n    typeof value.generatedAt === 'string' &&\n    typeof value.target === 'string' &&\n    Array.isArray(value.files) &&\n    value.files.every((filePath) => typeof filePath === 'string') &&\n    Array.isArray(value.warnings) &&\n    value.warnings.every((warning) => typeof warning === 'string')\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction uniqueStrings(values: readonly string[]): readonly string[] {\n  return [...new Set(values)];\n}\n"]}

package/dist/readme-usage.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=readme-usage.d.ts.map

package/dist/readme-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-usage.d.ts","sourceRoot":"","sources":["../src/readme-usage.ts"],"names":[],"mappings":""}

package/dist/readme-usage.js

@@ -0,0 +1,30 @@
+import { runCli } from './cli.js';
+/***
+ * Provider and CLI surface
+ *
+ * `@ankhorage/infra` owns infra command behavior.
+ *
+ * The same shared command implementation backs both:
+ *
+ * - `ankh infra ...`
+ * - `bunx @ankhorage/infra ...`
+ *
+ * Current command surface:
+ *
+ * - `validate`
+ * - `generate`
+ * - `status`
+ * - `up`
+ * - `down`
+ *
+ * `status` runs the generated live runtime status script for a project.
+ *
+ * Project resolution is project-aware:
+ *
+ * - pass `[project]`, or
+ * - omit it when cwd is already inside `apps/<project>`
+ *
+ * @usage
+ */
+await runCli(['--help']);
+//# sourceMappingURL=readme-usage.js.map

package/dist/readme-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-usage.js","sourceRoot":"","sources":["../src/readme-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC","sourcesContent":["import { runCli } from './cli.js';\n\n/***\n * Provider and CLI surface\n *\n * `@ankhorage/infra` owns infra command behavior.\n *\n * The same shared command implementation backs both:\n *\n * - `ankh infra ...`\n * - `bunx @ankhorage/infra ...`\n *\n * Current command surface:\n *\n * - `validate`\n * - `generate`\n * - `status`\n * - `up`\n * - `down`\n *\n * `status` runs the generated live runtime status script for a project.\n *\n * Project resolution is project-aware:\n *\n * - pass `[project]`, or\n * - omit it when cwd is already inside `apps/<project>`\n *\n * @usage\n */\nawait runCli(['--help']);\n"]}

package/dist/runtime.d.ts

@@ -0,0 +1,26 @@
+import type { InfraCommandContext } from './commandContext.js';
+export type InfraLifecycleScript = 'down' | 'status' | 'up';
+export declare class InfraScriptExecutionError extends Error {
+    readonly exitCode: number | null;
+    readonly stderr: string;
+    readonly stdout: string;
+    constructor(args: {
+        readonly exitCode: number | null;
+        readonly message: string;
+        readonly stderr: string;
+        readonly stdout: string;
+    });
+}
+export declare function runProjectInfraScript(args: {
+    readonly context: InfraCommandContext;
+    readonly projectId: string;
+    readonly projectPath: string;
+    readonly script: InfraLifecycleScript;
+    readonly target: string;
+}): Promise<void>;
+export declare function resolveProjectInfraScriptPath(args: {
+    readonly projectPath: string;
+    readonly script: InfraLifecycleScript;
+    readonly target: string;
+}): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;AAE5D,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB;CAOF;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAET"}