@amalgm/apps 0.1.0 → 0.1.1

package/PURPOSE.md

@@ -16,6 +16,10 @@ product beside independently supervised Events, Realtime, and other products;
 it supplies identity, transport, and UI composition but does not absorb their
 domain supervisors or maintain a second app lifecycle implementation.
 
+Runtime hosts may mount the Apps HTTP catalog, including its legacy Artifacts
+projection, without becoming lifecycle authorities. Catalog reads come from
+the same Apps store as the SDK, CLI, and MCP surfaces.
+
 ## Primitives
 
 - An **app** is a stable local identity with a user-controlled name, route,

package/README.md

@@ -42,6 +42,21 @@ await apps.deploy(app.id);
 await apps.rollback(app.id);
 ```
 
+The same persisted catalog has an HTTP adapter for runtime hosts:
+
+```ts
+import { Apps } from '@amalgm/apps';
+import { createAppsHttpServer } from '@amalgm/apps/http';
+
+const apps = new Apps({ stateDir: '/var/lib/amalgm/apps' });
+const http = createAppsHttpServer(apps);
+await http.listen();
+```
+
+It serves modern `/apps` and engine-compatible `/apps/list` catalogs plus
+their `/artifacts` legacy projection. Lifecycle choices remain on the SDK,
+CLI, and MCP surfaces; this HTTP increment is read-only.
+
 The SDK, supervisor, CLI, MCP server, lease, and tests are authored in
 TypeScript. `npm run build` emits the CommonJS runtime and declarations into
 `dist/`; generated output is not a second source tree.

package/dist/http.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Apps catalog HTTP adapter. Route and projection laws come from engine
+ * `runtime/scripts/amalgm-mcp/server/routes/apps.js` and
+ * `runtime/scripts/amalgm-mcp/apps/rest.js`.
+ *
+ * Lifecycle mutations are deliberately absent here: the owning Apps service
+ * already exposes them through SDK, CLI, and MCP, and the shell campaign must
+ * not choose how the production runtime starts or supervises apps.
+ */
+import type { AddressInfo } from 'node:net';
+import type { Apps } from './apps.js';
+import type { AppView } from './types.js';
+type CatalogApp = AppView & {
+    kind: 'app';
+    cwd: string;
+    app_ref: string;
+    appUrl: string;
+};
+type LegacyArtifact = Omit<CatalogApp, 'kind'> & {
+    kind: 'artifact';
+    artifactRef: string;
+    artifact_ref: string;
+    artifactUrl: string;
+};
+interface AppsHttpServer {
+    listen(port?: number, host?: string): Promise<AddressInfo>;
+    close(): Promise<void>;
+}
+declare function createAppsHttpServer(apps: Apps): AppsHttpServer;
+export { createAppsHttpServer };
+export type { AppsHttpServer, CatalogApp, LegacyArtifact };

package/dist/http.js

@@ -0,0 +1,78 @@
+/**
+ * Apps catalog HTTP adapter. Route and projection laws come from engine
+ * `runtime/scripts/amalgm-mcp/server/routes/apps.js` and
+ * `runtime/scripts/amalgm-mcp/apps/rest.js`.
+ *
+ * Lifecycle mutations are deliberately absent here: the owning Apps service
+ * already exposes them through SDK, CLI, and MCP, and the shell campaign must
+ * not choose how the production runtime starts or supervises apps.
+ */
+import http from 'node:http';
+function catalogApp(app) {
+    return {
+        ...app,
+        kind: 'app',
+        cwd: app.sourceDir,
+        app_ref: app.appRef,
+        appUrl: app.publicUrl,
+    };
+}
+function legacyArtifact(app) {
+    const catalog = catalogApp(app);
+    return {
+        ...catalog,
+        kind: 'artifact',
+        artifactRef: catalog.appRef,
+        artifact_ref: catalog.appRef,
+        artifactUrl: catalog.appUrl || catalog.publicUrl,
+    };
+}
+function legacyRoutes(routes) {
+    return routes.map((route) => ({
+        artifact_ref: route.app_ref,
+        port: route.port,
+        name: route.name,
+    }));
+}
+function createAppsHttpServer(apps) {
+    const server = http.createServer((request, response) => {
+        const url = new URL(request.url || '/', 'http://127.0.0.1');
+        if (request.method !== 'GET')
+            return json(response, 405, { error: 'Method not allowed' });
+        if (url.pathname === '/apps' || url.pathname === '/apps/list') {
+            return json(response, 200, { version: 1, apps: apps.list().map(catalogApp) });
+        }
+        if (url.pathname === '/apps/routes') {
+            return json(response, 200, { routes: apps.routes() });
+        }
+        if (url.pathname === '/artifacts' || url.pathname === '/artifacts/list') {
+            return json(response, 200, { version: 1, artifacts: apps.list().map(legacyArtifact) });
+        }
+        if (url.pathname === '/artifacts/routes') {
+            return json(response, 200, { routes: legacyRoutes(apps.routes()) });
+        }
+        return json(response, 404, { error: 'Not found' });
+    });
+    return {
+        listen(port = 0, host = '127.0.0.1') {
+            return new Promise((resolve, reject) => {
+                server.once('error', reject);
+                server.listen(port, host, () => {
+                    server.off('error', reject);
+                    resolve(server.address());
+                });
+            });
+        },
+        close() {
+            return new Promise((resolve, reject) => {
+                server.close((error) => error ? reject(error) : resolve());
+            });
+        },
+    };
+}
+function json(response, status, body) {
+    response.writeHead(status, { 'content-type': 'application/json' });
+    response.end(JSON.stringify(body));
+}
+export { createAppsHttpServer };
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,5 +4,7 @@ export * from './lease.js';
 export { normalizeManifest, readManifest } from './manifest.js';
 export { createMcpTools } from './mcp.js';
 export { createMcpServer } from './mcp-server.js';
+export { createAppsHttpServer } from './http.js';
+export type { AppsHttpServer, CatalogApp, LegacyArtifact } from './http.js';
 export { inspectPackage, materialize, packPackage, unpackPackage, validatePackageFiles, } from './package.js';
 export type * from './types.js';

package/dist/index.js

@@ -4,5 +4,6 @@ export * from './lease.js';
 export { normalizeManifest, readManifest } from './manifest.js';
 export { createMcpTools } from './mcp.js';
 export { createMcpServer } from './mcp-server.js';
+export { createAppsHttpServer } from './http.js';
 export { inspectPackage, materialize, packPackage, unpackPackage, validatePackageFiles, } from './package.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/apps",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local-first, versioned application deployment for Amalgm.",
   "license": "UNLICENSED",
   "private": false,
@@ -23,6 +23,10 @@
     "./lease": {
       "types": "./dist/lease.d.ts",
       "default": "./dist/lease.js"
+    },
+    "./http": {
+      "types": "./dist/http.d.ts",
+      "default": "./dist/http.js"
     }
   },
   "bin": {