getmyenv 0.5.2 → 0.6.0

package/dist/lib/fs.d.ts

@@ -1,19 +1,21 @@
+/**
+ * `.getmyenv/project.json`, committed so a clone knows its project.
+ * Holds no API URL: a committed file must not redirect where tokens go.
+ */
 export type ProjectMeta = {
     projectId?: string;
     projectName?: string;
-    apiUrl?: string;
-    /** Environment for this folder, set at link time. */
-    environment?: "development" | "production";
-};
-export type RequirementsMeta = {
-    required: string[];
+    /** Default context slug for this folder. */
+    context?: string;
 };
+/**
+ * Nearest folder at or above cwd with a linked `.getmyenv/`, so commands work
+ * from subfolders. Stops at a git repo root. Falls back to cwd.
+ */
 export declare function getProjectRoot(cwd?: string): string;
 export declare function getGetenvDir(cwd?: string): string;
 export declare function readProjectMeta(cwd?: string): ProjectMeta | null;
 export declare function writeProjectMeta(meta: ProjectMeta, cwd?: string): void;
-export declare function writeRequirements(required: string[], cwd?: string): void;
-export declare function readRequirements(cwd?: string): string[];
 /** OS user config for machine identity - never in the repo. */
 export declare function getConfigDir(): string;
 /**
@@ -29,16 +31,15 @@ export declare function readLine(question: string): Promise<string>;
 export declare function promptHidden(question: string, opts?: {
     allowStdin?: boolean;
 }): Promise<string>;
+/** Yes/no on a TTY. Empty input picks the default, which is No unless `defaultYes`. */
 export declare function promptConfirm(question: string, opts?: {
     defaultYes?: boolean;
 }): Promise<boolean>;
 /** 1-based numbered choice. Empty input selects defaultIndex (0-based). */
 export declare function promptChoice(question: string, options: string[], defaultIndex?: number): Promise<number>;
-/** Throw with clear next steps when this folder has no linked project. */
-export declare function requireLinkedProject(meta: ProjectMeta | null): asserts meta is ProjectMeta & {
-    projectId: NonNullable<ProjectMeta["projectId"]>;
-};
 export declare function ensureGitignoreHasEnv(cwd?: string): void;
+/** Ignore one plaintext file written by `export -o`. Files outside the project are left alone. */
+export declare function ensureGitignoreHas(file: string, cwd?: string): void;
 export type ClaimFile = {
     version: 1;
     claimCode: string;
@@ -52,36 +53,24 @@ export declare function claimFilePath(cwd?: string): string;
 export declare function readClaimFile(cwd?: string): ClaimFile | null;
 export declare function writeClaimFile(data: Omit<ClaimFile, "version">, cwd?: string): string;
 export declare function clearClaimFile(cwd?: string): boolean;
-/** First-class languages shown on landing / docs. */
-export type DetectedLanguage = "node" | "python" | "ruby" | "rust" | "go" | "php" | "java" | "dotnet";
-/** Detect project languages from framework markers (names only, no values). */
-export declare function detectLanguages(cwd?: string): Array<{
-    language: DetectedLanguage;
-    label: string;
-}>;
-/** Native env-read snippet for a language (for migrate / docs messaging). */
-export declare function envReadSnippet(language: DetectedLanguage | null, name: string): string;
-/**
- * Detect env var names from .env* and common source patterns across languages.
- * NEVER returns or collects secret values.
- */
-export declare function detectEnvNames(cwd?: string): string[];
+/** dotenv rules (multiline values, inline comments, BOM), valid names only. */
+export declare function parseEnvText(text: string): Record<string, string>;
+/** `parseEnvText` for a file. A missing file reads as empty. */
 export declare function parseEnvFile(filePath: string): Record<string, string>;
+/** `.example`, `.sample` and `.template` files hold placeholders, not values. */
 export declare function isEnvSampleFile(filePath: string): boolean;
 /**
- * Recursively find .env* files under cwd (including .example / .sample after a pull).
- * Skips common junk directories and *.migrated.local.
+ * Recursively find .env* files under cwd, including .example / .sample.
+ * Skips common junk directories.
  */
 export declare function listEnvFiles(cwd?: string): string[];
-/** First candidate from listEnvFiles, or null. */
-export declare function findEnvFile(cwd?: string): string | null;
-/** Basename contains "production" (e.g. .env.production, .env.production.local). */
-export declare function isProductionEnvFilename(filePath: string): boolean;
+/** Env files in this folder only (not subfolders). Samples skipped. */
+export declare function rootEnvFiles(cwd?: string): string[];
 /**
- * Env files safe to push: every .env* candidate except production-named files.
- * Production values belong in the dashboard, not in the repo.
+ * Context slug implied by an env file name.
+ * `.env.staging` and `.env.staging.local` map to `staging`.
+ * `.env` and `.env.local` map to null (use the default context).
+ * Sample files map to null too.
  */
-export declare function listPushEnvFiles(cwd?: string): string[];
-/** Infer CLI -e name from an env file basename. */
-export declare function inferEnvNameFromFile(filePath: string): string;
+export declare function contextSlugFromEnvFile(filePath: string): string | null;
 //# sourceMappingURL=fs.d.ts.map

package/dist/lib/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/lib/fs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/lib/fs.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAgB,GAAG,MAAM,CAc1D;AAED,wBAAgB,YAAY,CAAC,GAAG,SAAgB,GAAG,MAAM,CAExD;AAED,wBAAgB,eAAe,CAAC,GAAG,SAAgB,GAAG,WAAW,GAAG,IAAI,CAwBvE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,SAAgB,GAAG,IAAI,CAiB7E;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAkBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB1D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,OAAO,CAAC,MAAM,CAAC,CAsDjB;AAED,uFAAuF;AACvF,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,2EAA2E;AAC3E,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,SAAI,GACf,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,SAAgB,GAAG,IAAI,CAwB/D;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,IAAI,CAY1E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,MAAM,CAEzD;AAED,wBAAgB,aAAa,CAAC,GAAG,SAAgB,GAAG,SAAS,GAAG,IAAI,CA2BnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,GAAG,SAAgB,GAAG,MAAM,CAQ5F;AAED,wBAAgB,cAAc,CAAC,GAAG,SAAgB,GAAG,OAAO,CAK3D;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMjE;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGrE;AAqCD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOzD;AAsBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,SAAgB,GAAG,MAAM,EAAE,CA6B1D;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,GAAG,SAAgB,GAAG,MAAM,EAAE,CAK1D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOtE"}