@jonathanleelx/meddle 0.5.0-beta.9 → 0.5.1

package/dist/core/mock-handler.d.ts

@@ -1,5 +1,68 @@
 import type { ProxyContext, MockHandler, MockRuleEntry } from './types';
 /** 按 id 去重，后出现的条目覆盖先前的（与前端 use-mocks 行为一致） */
 export declare function dedupeMockRulesById(rules: MockRuleEntry[]): MockRuleEntry[];
+export interface MocksParseError {
+    /** 1-based line of the parse failure (null when the engine gives no position). */
+    line: number | null;
+    /** 1-based column of the parse failure. */
+    column: number | null;
+    /** Raw JSON.parse message. */
+    message: string;
+}
+/** Thrown when a write would overwrite a mocks file that failed to parse (issue #120). */
+export declare class MocksFileInvalidError extends Error {
+    readonly filePath: string;
+    readonly parseError: MocksParseError;
+    readonly code = "MOCKS_FILE_INVALID";
+    constructor(filePath: string, parseError: MocksParseError);
+}
+export declare function formatMocksParseError(filePath: string, err: MocksParseError): string;
+/** Valid mocks.json is an object with a `rules` array. Empty / whitespace files skip this. */
+export declare const MOCKS_MISSING_RULES_MESSAGE = "\u7F3A\u5C11 rules \u6570\u7EC4";
+export declare function mocksDocumentShapeError(data: unknown): string | null;
+/**
+ * Parse mocks file text. Issue #120: empty / whitespace-only text is an empty
+ * rule list (not an error); anything else that fails JSON.parse returns a
+ * parse error with 1-based line/column. Issue #160: JSON that parses but is
+ * not `{ rules: [...] }` is the same class of error (do not treat as []).
+ */
+export declare function parseMocksFileText(text: string): {
+    data: any;
+    error: null;
+} | {
+    data: null;
+    error: MocksParseError;
+};
+/**
+ * Offset of the first JSON syntax error (V8 does not always report a
+ * position, e.g. "Unexpected token ']', ... is not valid JSON").
+ */
+export declare function findJsonErrorOffset(t: string): number;
+export declare function resolveMocksWriteTarget(file: string): string;
+/**
+ * Issue #121: turn the configured `mocksFilePath` into an absolute path.
+ * `~` / `~/…` expand to the user's home directory; a relative path is
+ * resolved against the meddle directory (MEDDLE_HOME), not the directory the
+ * proxy happened to be started from.
+ */
+export declare function resolveConfiguredMocksPath(raw: string | null | undefined, meddleDir: string, homeDir?: string): string | null;
+export interface LegacyMocksPath {
+    /** What the user configured (a relative path). */
+    configured: string;
+    /** Where the file was found under the old rule (relative to the proxy's start directory). */
+    oldPath: string;
+    /** Where the path resolves now (relative to MEDDLE_HOME); does not exist. */
+    newPath: string;
+}
+/**
+ * Issue #121 migration notice: a relative `mocksFilePath` used to resolve
+ * against the proxy's start directory. If the file exists there but not
+ * under the new rule (MEDDLE_HOME), report both paths so the user can switch
+ * to the old absolute path. Never migrates or rewrites settings.
+ */
+export declare function detectLegacyMocksPath(raw: string | null | undefined, meddleDir: string, cwd?: string, homeDir?: string): LegacyMocksPath | null;
+export declare function formatLegacyMocksNotice(l: LegacyMocksPath): string;
+/** Read the raw (unresolved) mocksFilePath from settings.json. */
+export declare function readConfiguredMocksPath(settingsPath: string): string | null;
 export declare function createMockHandler(ctx: ProxyContext): MockHandler;
 //# sourceMappingURL=mock-handler.d.ts.map

package/dist/core/mock-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock-handler.d.ts","sourceRoot":"","sources":["../../core/mock-handler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAIvE,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CAoPhE"}
+{"version":3,"file":"mock-handler.d.ts","sourceRoot":"","sources":["../../core/mock-handler.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAYvE,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAQ3E;AAED,MAAM,WAAW,eAAe;IAC5B,kFAAkF;IAClF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,0FAA0F;AAC1F,qBAAa,qBAAsB,SAAQ,KAAK;IAEhC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAAE,QAAQ,CAAC,UAAU,EAAE,eAAe;IAD3E,QAAQ,CAAC,IAAI,wBAAuB;gBACf,QAAQ,EAAE,MAAM,EAAW,UAAU,EAAE,eAAe;CAI9E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAGpF;AAED,8FAA8F;AAC9F,eAAO,MAAM,2BAA2B,oCAAgB,CAAA;AAExD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAyBpH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAmDrD;AAoBD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,GAAG,IAAI,CAO3I;AAED,MAAM,WAAW,eAAe;IAC5B,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAA;IAClB,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,EAAE,OAAO,GAAE,MAAqB,GAAG,eAAe,GAAG,IAAI,CAS5K;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAGlE;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CA4iBhE"}