@vjeko.com/al-object-id-ninja-mcp 1.0.0

package/README.md

@@ -0,0 +1,115 @@
+# AL Object ID Ninja MCP Server
+
+MCP (Model Context Protocol) server for [AL Object ID Ninja](https://marketplace.visualstudio.com/items?itemName=vjeko.vjeko-al-objid) - the VS Code extension for managing AL object IDs in Business Central development.
+
+## Features
+
+This MCP server provides two tools for AI assistants:
+
+- **ninja_assignObjectId** - Assigns and commits the next available AL object ID
+- **ninja_unassignObjectId** - Releases a previously assigned object ID
+
+## Installation
+
+### VS Code (Insiders)
+
+Search for "AL Object ID Ninja" in the MCP Servers gallery, or add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "al-object-id-ninja": {
+      "command": "npx",
+      "args": ["-y", "@vjeko.com/al-object-id-ninja-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to `~/.claude/mcp.json` (global) or `.claude/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "al-object-id-ninja": {
+      "command": "npx",
+      "args": ["-y", "@vjeko.com/al-object-id-ninja-mcp"]
+    }
+  }
+}
+```
+
+Then restart Claude Code or run `/mcp` to reload MCP servers.
+
+### Cursor
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "al-object-id-ninja": {
+      "command": "npx",
+      "args": ["-y", "@vjeko.com/al-object-id-ninja-mcp"]
+    }
+  }
+}
+```
+
+## Prerequisites
+
+Your AL app must be set up with AL Object ID Ninja:
+
+1. Have a valid `app.json` with `idRanges` configured
+2. Have a `.objidconfig` file with `authKey` (created when you authorize with Ninja)
+
+## Usage
+
+Once configured, AI assistants can use the tools to manage object IDs:
+
+### Assign an ID
+
+```
+"Assign a new table ID for my AL app"
+```
+
+The assistant will use `ninja_assignObjectId` with:
+- `objectType`: The AL object type (table, page, codeunit, etc.)
+- `targetFilePath`: Path to any file in your AL app
+- `rangeName`: (Optional) Logical range name if multiple ranges exist
+
+### Unassign an ID
+
+```
+"Release table ID 50100 - I deleted that object"
+```
+
+The assistant will use `ninja_unassignObjectId` with:
+- `objectType`: The AL object type
+- `objectId`: The ID to release
+- `targetFilePath`: Path to any file in your AL app
+
+## Supported Object Types
+
+- `table`, `tableextension`
+- `page`, `pageextension`
+- `codeunit`
+- `report`, `reportextension`
+- `query`
+- `xmlport`
+- `enum`, `enumextension`
+- `permissionset`, `permissionsetextension`
+- `table_{id}` (for table fields)
+- `enum_{id}` (for enum values)
+
+## Links
+
+- [AL Object ID Ninja Extension](https://marketplace.visualstudio.com/items?itemName=vjeko.vjeko-al-objid)
+- [Documentation](https://github.com/vjekob/al-objid)
+- [Report Issues](https://github.com/vjekob/al-objid/issues)
+
+## License
+
+MIT

package/dist/src/al-app/ALApp.d.ts

@@ -0,0 +1,52 @@
+import { ALAppManifest } from "./ALAppManifest";
+import { ObjIdConfig } from "./ObjIdConfig";
+import { NinjaALRange } from "../types/NinjaALRange";
+/**
+ * Simplified ALApp representation for MCP server.
+ * No watchers, events, or disposables - just reads the app once.
+ */
+export declare class ALApp {
+    private readonly _rootPath;
+    private readonly _manifest;
+    private readonly _config;
+    private _hash;
+    private constructor();
+    /**
+     * Tries to create an ALApp instance from the given root path.
+     * @param rootPath Root path of the AL app (folder containing app.json)
+     * @returns ALApp instance or undefined if not a valid AL app
+     */
+    static tryCreate(rootPath: string): ALApp | undefined;
+    /**
+     * Root path of this AL app.
+     */
+    get rootPath(): string;
+    /**
+     * App manifest (`app.json`) representation as an object.
+     */
+    get manifest(): ALAppManifest;
+    /**
+     * Ninja config file (`.objidconfig`) representation as an object.
+     */
+    get config(): ObjIdConfig;
+    /**
+     * SHA256 hash of the app ID (the `id` property from `app.json`).
+     */
+    get hash(): string;
+    /**
+     * Returns the `authKey` property from the `.objidconfig` file.
+     */
+    get authKey(): string;
+    /**
+     * Gets effective ranges for an object type with proper fallback.
+     *
+     * Priority:
+     * 1. Object-type-specific ranges from `.objidconfig`
+     * 2. General id ranges from `.objidconfig`
+     * 3. Ranges from `app.json` manifest
+     *
+     * @param objectType The object type to get ranges for (e.g., "table", "codeunit")
+     * @returns Array of ranges applicable for the object type
+     */
+    getObjectTypeRanges(objectType: string): NinjaALRange[];
+}

package/dist/src/al-app/ALApp.js

@@ -0,0 +1,130 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALApp = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const getSha256_1 = require("../utils/getSha256");
+const ALAppManifest_1 = require("./ALAppManifest");
+const ObjIdConfig_1 = require("./ObjIdConfig");
+const APP_FILE_NAME = "app.json";
+const CONFIG_FILE_NAME = ".objidconfig";
+/**
+ * Simplified ALApp representation for MCP server.
+ * No watchers, events, or disposables - just reads the app once.
+ */
+class ALApp {
+    _rootPath;
+    _manifest;
+    _config;
+    _hash;
+    constructor(rootPath, manifest) {
+        this._rootPath = rootPath;
+        this._manifest = manifest;
+        const configPath = path.join(rootPath, CONFIG_FILE_NAME);
+        this._config = new ObjIdConfig_1.ObjIdConfig(configPath);
+    }
+    /**
+     * Tries to create an ALApp instance from the given root path.
+     * @param rootPath Root path of the AL app (folder containing app.json)
+     * @returns ALApp instance or undefined if not a valid AL app
+     */
+    static tryCreate(rootPath) {
+        const manifestPath = path.join(rootPath, APP_FILE_NAME);
+        if (!fs.existsSync(manifestPath)) {
+            return;
+        }
+        const manifest = ALAppManifest_1.ALAppManifest.tryCreate(manifestPath);
+        if (!manifest) {
+            return;
+        }
+        return new ALApp(rootPath, manifest);
+    }
+    /**
+     * Root path of this AL app.
+     */
+    get rootPath() {
+        return this._rootPath;
+    }
+    /**
+     * App manifest (`app.json`) representation as an object.
+     */
+    get manifest() {
+        return this._manifest;
+    }
+    /**
+     * Ninja config file (`.objidconfig`) representation as an object.
+     */
+    get config() {
+        return this._config;
+    }
+    /**
+     * SHA256 hash of the app ID (the `id` property from `app.json`).
+     */
+    get hash() {
+        return this._hash || (this._hash = (0, getSha256_1.getSha256)(this._manifest.id));
+    }
+    /**
+     * Returns the `authKey` property from the `.objidconfig` file.
+     */
+    get authKey() {
+        return this._config.authKey;
+    }
+    /**
+     * Gets effective ranges for an object type with proper fallback.
+     *
+     * Priority:
+     * 1. Object-type-specific ranges from `.objidconfig`
+     * 2. General id ranges from `.objidconfig`
+     * 3. Ranges from `app.json` manifest
+     *
+     * @param objectType The object type to get ranges for (e.g., "table", "codeunit")
+     * @returns Array of ranges applicable for the object type
+     */
+    getObjectTypeRanges(objectType) {
+        const configObjectRanges = this._config.objectRanges[objectType];
+        if (configObjectRanges && configObjectRanges.length > 0) {
+            return configObjectRanges;
+        }
+        const configIdRanges = this._config.idRanges;
+        if (configIdRanges.length > 0) {
+            return configIdRanges;
+        }
+        // Cast manifest ranges to NinjaALRange[] - they may lack description but that's ok
+        return this._manifest.idRanges;
+    }
+}
+exports.ALApp = ALApp;
+//# sourceMappingURL=ALApp.js.map

package/dist/src/al-app/ALApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ALApp.js","sourceRoot":"","sources":["../../../src/al-app/ALApp.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAC7B,uCAAyB;AACzB,kDAA+C;AAC/C,mDAAgD;AAChD,+CAA4C;AAG5C,MAAM,aAAa,GAAG,UAAU,CAAC;AACjC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAExC;;;GAGG;AACH,MAAa,KAAK;IACG,SAAS,CAAS;IAClB,SAAS,CAAgB;IACzB,OAAO,CAAc;IAC9B,KAAK,CAAqB;IAElC,YAAoB,QAAgB,EAAE,QAAuB;QACzD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAW,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,QAAgB;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,6BAAa,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO;QACX,CAAC;QAED,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAA,qBAAS,EAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IAED;;;;;;;;;;OAUG;IACI,mBAAmB,CAAC,UAAkB;QACzC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACjE,IAAI,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,OAAO,kBAAkB,CAAC;QAC9B,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC7C,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,cAAc,CAAC;QAC1B,CAAC;QAED,mFAAmF;QACnF,OAAO,IAAI,CAAC,SAAS,CAAC,QAA0B,CAAC;IACrD,CAAC;CACJ;AA5FD,sBA4FC"}

package/dist/src/al-app/ALAppManifest.d.ts

@@ -0,0 +1,39 @@
+import { ALRange } from "../types/ALRange";
+export declare class ALAppManifest {
+    private readonly _path;
+    private readonly _manifest;
+    private constructor();
+    static tryCreate(appJsonPath: string): ALAppManifest | undefined;
+    /**
+     * Path of the `app.json` file.
+     */
+    get path(): string;
+    /**
+     * The `id` property from the `app.json` file.
+     *
+     * ***DO NOT USE THIS PROPERTY UNLESS YOU ABSOLUTELY NEED IT!***
+     *
+     * **Instead, use the `hash` property from the parent object. The `id` property should be used
+     * only for informational purposes, typically when having to present it on screen.**
+     *
+     * ***NEVER SEND THIS PROPERTY TO THE BACK END!***
+     */
+    get id(): string;
+    /**
+     * The `name` property from the `app.json` file.
+     */
+    get name(): string;
+    /**
+     * The `publisher` property from the `app.json` file.
+     */
+    get publisher(): string;
+    /**
+     * The `version` property from the `app.json` file.
+     */
+    get version(): string;
+    /**
+     * The `idRanges` property from the `app.json` file.
+     */
+    get idRanges(): ALRange[];
+    get preprocessorSymbols(): string[];
+}

package/dist/src/al-app/ALAppManifest.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALAppManifest = void 0;
+const fs = __importStar(require("fs"));
+const comment_json_1 = require("comment-json");
+class ALAppManifest {
+    _path;
+    _manifest;
+    constructor(path, manifest) {
+        this._path = path;
+        this._manifest = manifest;
+    }
+    static tryCreate(appJsonPath) {
+        try {
+            const contents = fs.readFileSync(appJsonPath).toString();
+            const appObj = (0, comment_json_1.parse)(contents.replace(/^\uFEFF/, ""));
+            const expectProperty = (property, type = "string") => appObj.hasOwnProperty(property) && typeof appObj[property] === type;
+            if (!expectProperty("id") || !expectProperty("name") || !expectProperty("version")) {
+                return;
+            }
+            if (!appObj.idRanges && appObj.idRange) {
+                appObj.idRanges = [appObj.idRange];
+            }
+            if (!expectProperty("idRanges", "object")) {
+                return;
+            }
+            return new ALAppManifest(appJsonPath, appObj);
+        }
+        catch {
+            return;
+        }
+    }
+    /**
+     * Path of the `app.json` file.
+     */
+    get path() {
+        return this._path;
+    }
+    /**
+     * The `id` property from the `app.json` file.
+     *
+     * ***DO NOT USE THIS PROPERTY UNLESS YOU ABSOLUTELY NEED IT!***
+     *
+     * **Instead, use the `hash` property from the parent object. The `id` property should be used
+     * only for informational purposes, typically when having to present it on screen.**
+     *
+     * ***NEVER SEND THIS PROPERTY TO THE BACK END!***
+     */
+    get id() {
+        return this._manifest.id || "";
+    }
+    /**
+     * The `name` property from the `app.json` file.
+     */
+    get name() {
+        return this._manifest.name || "";
+    }
+    /**
+     * The `publisher` property from the `app.json` file.
+     */
+    get publisher() {
+        return this._manifest.publisher || "";
+    }
+    /**
+     * The `version` property from the `app.json` file.
+     */
+    get version() {
+        return this._manifest.version || "";
+    }
+    /**
+     * The `idRanges` property from the `app.json` file.
+     */
+    get idRanges() {
+        return this._manifest.idRanges || [];
+    }
+    get preprocessorSymbols() {
+        return this._manifest.preprocessorSymbols || [];
+    }
+}
+exports.ALAppManifest = ALAppManifest;
+//# sourceMappingURL=ALAppManifest.js.map

package/dist/src/al-app/ALAppManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ALAppManifest.js","sourceRoot":"","sources":["../../../src/al-app/ALAppManifest.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,+CAAqC;AAYrC,MAAa,aAAa;IACL,KAAK,CAAS;IACd,SAAS,CAAY;IAEtC,YAAoB,IAAY,EAAE,QAAmB;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,WAAmB;QACvC,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,IAAA,oBAAK,EAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAQ,CAAC;YAE7D,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAE,IAAI,GAAG,QAAQ,EAAE,EAAE,CACzD,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;YACxE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjF,OAAO;YACX,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrC,MAAM,CAAC,QAAQ,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACxC,OAAO;YACX,CAAC;YAED,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO;QACX,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;;;OASG;IACH,IAAW,EAAE;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,IAAW,mBAAmB;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,mBAAmB,IAAI,EAAE,CAAC;IACpD,CAAC;CACJ;AArFD,sCAqFC"}

package/dist/src/al-app/AppResolver.d.ts

@@ -0,0 +1,24 @@
+import { ALApp } from "./ALApp";
+/**
+ * Resolves file paths to ALApp instances.
+ * Walks up the directory tree to find app.json and caches resolved apps.
+ */
+export declare class AppResolver {
+    private static _cache;
+    /**
+     * Resolves a file path to its containing AL app.
+     * @param filePath Path to a file within an AL app
+     * @returns ALApp instance or undefined if not within an AL app
+     */
+    static resolveFromPath(filePath: string): ALApp | undefined;
+    /**
+     * Walks up the directory tree to find the AL app root (folder containing app.json).
+     * @param startDir Directory to start searching from
+     * @returns Path to the app root or undefined if not found
+     */
+    private static findAppRoot;
+    /**
+     * Clears the app cache.
+     */
+    static clearCache(): void;
+}

package/dist/src/al-app/AppResolver.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppResolver = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const ALApp_1 = require("./ALApp");
+const APP_FILE_NAME = "app.json";
+/**
+ * Resolves file paths to ALApp instances.
+ * Walks up the directory tree to find app.json and caches resolved apps.
+ */
+class AppResolver {
+    static _cache = new Map();
+    /**
+     * Resolves a file path to its containing AL app.
+     * @param filePath Path to a file within an AL app
+     * @returns ALApp instance or undefined if not within an AL app
+     */
+    static resolveFromPath(filePath) {
+        // Normalize the path
+        const normalizedPath = path.resolve(filePath);
+        // Check cache for the directory
+        const dir = fs.statSync(normalizedPath).isDirectory() ? normalizedPath : path.dirname(normalizedPath);
+        const appRoot = this.findAppRoot(dir);
+        if (!appRoot) {
+            return undefined;
+        }
+        // Check if we already have this app cached
+        const cached = this._cache.get(appRoot);
+        if (cached !== undefined) {
+            return cached || undefined;
+        }
+        // Try to create the app
+        const app = ALApp_1.ALApp.tryCreate(appRoot);
+        this._cache.set(appRoot, app || null);
+        return app || undefined;
+    }
+    /**
+     * Walks up the directory tree to find the AL app root (folder containing app.json).
+     * @param startDir Directory to start searching from
+     * @returns Path to the app root or undefined if not found
+     */
+    static findAppRoot(startDir) {
+        let currentDir = startDir;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const appJsonPath = path.join(currentDir, APP_FILE_NAME);
+            if (fs.existsSync(appJsonPath)) {
+                return currentDir;
+            }
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                // Reached filesystem root
+                return undefined;
+            }
+            currentDir = parentDir;
+        }
+    }
+    /**
+     * Clears the app cache.
+     */
+    static clearCache() {
+        this._cache.clear();
+    }
+}
+exports.AppResolver = AppResolver;
+//# sourceMappingURL=AppResolver.js.map

package/dist/src/al-app/AppResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppResolver.js","sourceRoot":"","sources":["../../../src/al-app/AppResolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAC7B,uCAAyB;AACzB,mCAAgC;AAEhC,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC;;;GAGG;AACH,MAAa,WAAW;IACZ,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAExD;;;;OAIG;IACI,MAAM,CAAC,eAAe,CAAC,QAAgB;QAC1C,qBAAqB;QACrB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE9C,gCAAgC;QAChC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACtG,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,2CAA2C;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,MAAM,IAAI,SAAS,CAAC;QAC/B,CAAC;QAED,wBAAwB;QACxB,MAAM,GAAG,GAAG,aAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;QACtC,OAAO,GAAG,IAAI,SAAS,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,WAAW,CAAC,QAAgB;QACvC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAE1B,iDAAiD;QACjD,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YACzD,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,OAAO,UAAU,CAAC;YACtB,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;gBAC3B,0BAA0B;gBAC1B,OAAO,SAAS,CAAC;YACrB,CAAC;YACD,UAAU,GAAG,SAAS,CAAC;QAC3B,CAAC;IACL,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,UAAU;QACpB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;;AA7DL,kCA8DC"}

package/dist/src/al-app/ObjIdConfig.d.ts

@@ -0,0 +1,23 @@
+import { PropertyBag } from "../types/PropertyBag";
+import { NinjaALRange } from "../types/NinjaALRange";
+/**
+ * Read-only representation of the .objidconfig file.
+ */
+export declare class ObjIdConfig {
+    private readonly _path;
+    private readonly _config;
+    constructor(configPath: string);
+    private read;
+    get path(): string;
+    get authKey(): string;
+    get appPoolId(): string;
+    get idRanges(): NinjaALRange[];
+    get objectRanges(): PropertyBag<NinjaALRange[]>;
+    /**
+     * Gets ranges for the specified object type.
+     * Falls back to idRanges if no object-specific ranges are defined.
+     * @param objectType Object type for which to get ranges
+     * @returns Ranges for the specified object type
+     */
+    getObjectTypeRanges(objectType: string): NinjaALRange[];
+}