@microsoft/managed-apps-dev-gateway 0.3.1

package/dist/snapshot/SnapshotSource.js

@@ -0,0 +1,81 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { validateDevelopmentSnapshotUpdate } from '@microsoft/managed-apps-common/gateway';
+import { readDevelopmentSnapshotAsync } from './SnapshotReader.js';
+/**
+ * Holds the last snapshot that read and validated cleanly, and mints the combined
+ * revision for one bootstrap lifetime.
+ *
+ * A failed refresh leaves the previous snapshot installed and rethrows, so invalid
+ * input can never downgrade a working session to an empty manifest. This is state
+ * for a caller that decides *when* to refresh; it is not a watcher, debouncer or
+ * session coordinator, and it performs no HTTP work.
+ */
+export class DevelopmentSnapshotSource {
+    projectRoot;
+    revision = 0;
+    current;
+    /**
+     * Tail of the serialized refresh queue. Refreshes must not interleave: the
+     * combined revision is allocated from `this.revision`, and an `await` between
+     * allocation and installation would let two overlapping refreshes both mint
+     * `N + 1` and hand back distinct snapshots carrying the same revision. Each
+     * caller installs a fulfilled gate before awaiting the previous one, preserving
+     * FIFO order without letting a failed refresh poison the callers behind it.
+     */
+    pending = Promise.resolve();
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /** The last successful read, or `undefined` before the first one. */
+    get snapshot() {
+        return this.current?.snapshot;
+    }
+    /** Init bytes matching {@link snapshot}, retained for exact-body retries. */
+    get initBody() {
+        return this.current?.initBody;
+    }
+    /**
+     * Re-read the project. On success the new snapshot is installed and classified
+     * relative to the previous one, so a caller can tell a connector-only metadata
+     * update from an OOB or identity change. On failure the previous snapshot stays
+     * installed and the error propagates.
+     *
+     * Concurrent calls are serialized, not coalesced: every call performs its own
+     * read, in call order, and observes the state left by the one before it.
+     */
+    async refreshAsync() {
+        const previous = this.pending;
+        let release = () => undefined;
+        this.pending = new Promise((resolve) => {
+            release = resolve;
+        });
+        await previous;
+        try {
+            return await this.readAndInstallAsync();
+        }
+        finally {
+            release();
+        }
+    }
+    async readAndInstallAsync() {
+        const previous = this.current;
+        const read = await readDevelopmentSnapshotAsync({
+            projectRoot: this.projectRoot,
+            revision: this.revision + 1,
+        });
+        if (previous && read.snapshot.oob.revision === previous.snapshot.oob.revision) {
+            // Nothing the consumers care about changed; keep the installed revision so
+            // an idle poll cannot exhaust the safe-integer revision space.
+            if (JSON.stringify(read.snapshot.hostConfig) === JSON.stringify(previous.snapshot.hostConfig)) {
+                return { read: previous, change: 'metadata' };
+            }
+        }
+        const { change } = validateDevelopmentSnapshotUpdate(read.snapshot, previous?.snapshot);
+        this.revision = read.snapshot.revision;
+        this.current = read;
+        return { read, change };
+    }
+}
+//# sourceMappingURL=SnapshotSource.js.map

package/dist/snapshot/SnapshotSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotSource.js","sourceRoot":"","sources":["../../src/snapshot/SnapshotSource.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAG3F,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAAyB;IACnB,WAAW,CAAS;IAC7B,QAAQ,GAAG,CAAC,CAAC;IACb,OAAO,CAAsC;IACrD;;;;;;;OAOG;IACK,OAAO,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnD,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;IAChC,CAAC;IAED,6EAA6E;IAC7E,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,YAAY;QAIvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,IAAI,OAAO,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC3C,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1C,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAI/B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,4BAA4B,CAAC;YAC9C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;SAC5B,CAAC,CAAC;QAEH,IAAI,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9E,2EAA2E;YAC3E,+DAA+D;YAC/D,IACE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EACzF,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;YAChD,CAAC;QACH,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,iCAAiC,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACxF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF"}

package/dist/snapshot/index.d.ts

@@ -0,0 +1,9 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export { canonicalJson, computeOobRevision } from './OobRevision.js';
+export { assertRealPathContainedAsync, canonicalizeRootAsync, resolveSchemaPathAsync, SnapshotReadError, SnapshotReadErrorCode, } from './PathPolicy.js';
+export type { DevelopmentSnapshotRead, ReadDevelopmentSnapshotOptions } from './SnapshotReader.js';
+export { readDevelopmentSnapshotAsync } from './SnapshotReader.js';
+export { DevelopmentSnapshotSource } from './SnapshotSource.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/snapshot/index.js

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export { canonicalJson, computeOobRevision } from './OobRevision.js';
+export { assertRealPathContainedAsync, canonicalizeRootAsync, resolveSchemaPathAsync, SnapshotReadError, SnapshotReadErrorCode, } from './PathPolicy.js';
+export { readDevelopmentSnapshotAsync } from './SnapshotReader.js';
+export { DevelopmentSnapshotSource } from './SnapshotSource.js';
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@microsoft/managed-apps-dev-gateway",
+  "version": "0.3.1",
+  "type": "module",
+  "description": "Local development bootstrap resources for Microsoft Managed Apps",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./snapshot": {
+      "types": "./dist/snapshot/index.d.ts",
+      "default": "./dist/snapshot/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc-esm-fix --target dist && bun scripts/copy-resources.ts",
+    "dev": "tsc -p tsconfig.json --watch",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "bun test --isolate src/",
+    "clean": "bun ../../scripts/clean.ts dist .turbo tsconfig.tsbuildinfo tsconfig.build.tsbuildinfo"
+  },
+  "dependencies": {
+    "@microsoft/managed-apps-common": "0.25.0",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@microsoft/managed-apps-gateway-client": "0.1.0",
+    "@repo/repo-config": "0.0.0",
+    "@types/bun": "1.3.13",
+    "@types/node": "24.13.1",
+    "tsc-esm-fix": "3.1.2",
+    "typescript": "5.9.3"
+  },
+  "keywords": [
+    "microsoft-managed-apps",
+    "local-development"
+  ]
+}