@x12i/memorix-service 0.0.0-bootstrap.0

package/dist/platform.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Production platform composition root — live wiring to accepted packages.
+ * Org-scoped metadata store; fail-closed when ports missing in prod.
+ */
+import { MongoClient, type Db } from "mongodb";
+import { type UnifiedMetadataClient } from "@x12i/memorix-metadata-runtime";
+import { type MemorixContentReader, type MemorixContentWriter, type MemorixAbstractWriter } from "@x12i/memorix-data";
+import { type RelationshipEngine } from "@x12i/memorix-relationships";
+import { type MemoryCollector } from "@x12i/memorix-memory";
+import { type IntelligenceArtifactPersistence } from "@x12i/memorix-intelligence";
+import { type RunLedger, type PipelineRuntime } from "@x12i/memorix-pipeline/v2";
+import { ServiceError } from "./errors.js";
+import { type ServiceCatalog } from "./catalog-bridge.js";
+import type { MemorixScope } from "./scope.js";
+import { type IsolationSession } from "./isolation.js";
+export type RuntimeMode = "dev" | "prod";
+export type PlatformDeps = {
+    mode: RuntimeMode;
+    mongoUri?: string;
+    client?: MongoClient;
+    allowMemoryMetadata?: boolean;
+    /** When set, metadata is isolated to session.orgId_metadata (acceptance). */
+    isolation?: IsolationSession;
+};
+export type OrgPorts = {
+    catalog: ServiceCatalog;
+    reader: MemorixContentReader;
+    writer: MemorixContentWriter;
+    abstractWriter: MemorixAbstractWriter;
+    relationships: RelationshipEngine;
+    memory: MemoryCollector;
+    pipeline: PipelineRuntime;
+};
+export type MemorixPlatform = {
+    mode: RuntimeMode;
+    client: MongoClient | null;
+    metadata: UnifiedMetadataClient;
+    isolation: IsolationSession | null;
+    operationalDbFor(orgId: string): Db;
+    metadataDbFor(orgId: string): Db;
+    pipelineLedgerFor(orgId: string): RunLedger;
+    intelligenceArtifactsFor(orgId: string): IntelligenceArtifactPersistence;
+    /** Fail-closed: throws if ports cannot be constructed. */
+    portsFor(scope: MemorixScope): OrgPorts;
+    close(): Promise<void>;
+    diagnostics(scope: MemorixScope): Record<string, unknown>;
+};
+export declare class PlatformStartupError extends ServiceError {
+    constructor(message: string);
+}
+export declare function createMemorixPlatform(deps: PlatformDeps): Promise<MemorixPlatform>;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,cAAc,EAAE,qBAAqB,CAAC;IACtC,aAAa,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CAAC;IACpC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CAAC;IACjC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,+BAA+B,CAAC;IACzE,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3D,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,eAAe,CAAC,CA4P1B"}

package/dist/platform.js

@@ -0,0 +1,246 @@
+/**
+ * Production platform composition root — live wiring to accepted packages.
+ * Org-scoped metadata store; fail-closed when ports missing in prod.
+ */
+import { MongoClient } from "mongodb";
+import { createInMemoryMetadataStore, createMetadataClient, } from "@x12i/memorix-metadata-runtime";
+import { createMongoContentReader, createMongoContentWriter, createMongoAbstractWriter, createMongoDataPlane, } from "@x12i/memorix-data";
+import { createMongoRelationshipStore } from "@x12i/memorix-relationship-store";
+import { createRelationshipEngine, } from "@x12i/memorix-relationships";
+import { createMemoryCollector, createMongoMemoryRunStore, createStaticCredentialProvider, createOpsFixtureConnector, } from "@x12i/memorix-memory";
+import { createIntelligenceArtifactPersistence, createMongoRunLedger, } from "@x12i/memorix-intelligence";
+import { createMongoRunLedger as createPipelineLedger, createPipelineRuntime, createLivePortRegistry, } from "@x12i/memorix-pipeline/v2";
+import { ServiceError } from "./errors.js";
+import { createMongoMetadataStore, } from "./mongo-metadata-store.js";
+import { catalogFromMetadataClient, relationshipMetadataResolver, } from "./catalog-bridge.js";
+import { assertSafeAcceptanceOrgId, recordCreatedDatabase, } from "./isolation.js";
+export class PlatformStartupError extends ServiceError {
+    constructor(message) {
+        super("PLATFORM_STARTUP_FAILED", message, 503);
+        this.name = "PlatformStartupError";
+    }
+}
+export async function createMemorixPlatform(deps) {
+    if (deps.mode !== "dev" && deps.mode !== "prod") {
+        throw new PlatformStartupError(`mode must be "dev" or "prod"`);
+    }
+    let client = null;
+    const ledgers = new Map();
+    const intelStores = new Map();
+    const portsCache = new Map();
+    let durableMetadata = null;
+    if (deps.mode === "prod") {
+        if (!deps.mongoUri && !deps.client) {
+            throw new PlatformStartupError("prod mode requires durable mongoUri (or injected MongoClient); no in-memory fallback");
+        }
+        if (deps.allowMemoryMetadata) {
+            throw new PlatformStartupError("prod mode rejects allowMemoryMetadata / in-memory metadata store");
+        }
+    }
+    if (deps.client) {
+        client = deps.client;
+    }
+    else if (deps.mongoUri) {
+        client = new MongoClient(deps.mongoUri);
+        await client.connect();
+    }
+    else if (deps.mode === "dev") {
+        client = null;
+    }
+    if (deps.mode === "prod" && !client) {
+        throw new PlatformStartupError("prod mode requires connected MongoClient");
+    }
+    if (deps.isolation) {
+        assertSafeAcceptanceOrgId(deps.isolation.orgId);
+    }
+    let metadata;
+    if (deps.mode === "prod" || (client && !deps.allowMemoryMetadata)) {
+        const metaDbName = deps.isolation
+            ? deps.isolation.isolatedMetadataDb
+            : "memorix_platform_metadata";
+        if (deps.isolation) {
+            // Touch creates DB; record in ledger
+            recordCreatedDatabase(deps.isolation, metaDbName);
+        }
+        const metaDb = client.db(metaDbName);
+        durableMetadata = createMongoMetadataStore(metaDb);
+        await durableMetadata.hydrate();
+        metadata = createMetadataClient(durableMetadata);
+    }
+    else {
+        metadata = createMetadataClient(createInMemoryMetadataStore());
+    }
+    function operationalDbFor(orgId) {
+        if (!client) {
+            throw new ServiceError("DURABLE_STORE_REQUIRED", "operational Mongo DB is required for this operation", 503);
+        }
+        if (deps.isolation) {
+            assertSafeAcceptanceOrgId(orgId);
+            if (orgId !== deps.isolation.orgId) {
+                throw new ServiceError("DB_ISOLATION_VIOLATION", "orgId does not match isolation session", 403);
+            }
+            recordCreatedDatabase(deps.isolation, `${orgId}_operational`);
+        }
+        return client.db(`${orgId}_operational`);
+    }
+    function metadataDbFor(orgId) {
+        if (!client) {
+            throw new ServiceError("DURABLE_STORE_REQUIRED", "mongo required", 503);
+        }
+        return client.db(`${orgId}_metadata`);
+    }
+    function pipelineLedgerFor(orgId) {
+        const existing = ledgers.get(orgId);
+        if (existing)
+            return existing;
+        if (deps.mode === "prod" || client) {
+            const ledger = createPipelineLedger(operationalDbFor(orgId));
+            ledgers.set(orgId, ledger);
+            return ledger;
+        }
+        throw new ServiceError("DURABLE_STORE_REQUIRED", "pipeline ledger requires durable mongo", 503);
+    }
+    function intelligenceArtifactsFor(orgId) {
+        const existing = intelStores.get(orgId);
+        if (existing)
+            return existing;
+        const ledger = createMongoRunLedger(operationalDbFor(orgId));
+        const store = createIntelligenceArtifactPersistence({
+            mode: deps.mode === "prod" ? "prod" : "dev",
+            orgId,
+            ledger,
+            allowMemoryArtifacts: false,
+            sessionId: `service:${orgId}`,
+        });
+        intelStores.set(orgId, store);
+        return store;
+    }
+    function portsFor(scope) {
+        if (!client) {
+            throw new ServiceError("CANONICAL_PORT_MISSING", "Mongo client required for data/relationship/memory/pipeline ports", 503);
+        }
+        const cacheKey = `${scope.orgId}:${scope.agentIds.join(",")}`;
+        const hit = portsCache.get(cacheKey);
+        if (hit)
+            return hit;
+        if (deps.isolation) {
+            assertSafeAcceptanceOrgId(scope.orgId);
+            for (const kind of ["entity", "event", "knowledge", "operational"]) {
+                recordCreatedDatabase(deps.isolation, `${scope.orgId}_${kind}`);
+            }
+        }
+        const catalog = catalogFromMetadataClient(metadata, scope.agentIds);
+        const plane = createMongoDataPlane(client);
+        const { writer } = createMongoContentWriter({ client, catalog, plane });
+        const { abstractWriter } = createMongoAbstractWriter({ client, catalog, plane });
+        const relationships = createRelationshipEngine({
+            client,
+            catalog,
+            metadataResolver: relationshipMetadataResolver(metadata),
+        });
+        const relStore = createMongoRelationshipStore({
+            client,
+            orgId: scope.orgId,
+            locator: {
+                async locate() {
+                    return { dataCategory: "entity" };
+                },
+            },
+        });
+        const { reader } = createMongoContentReader({
+            client,
+            catalog,
+            plane,
+            relationshipStore: relStore,
+        });
+        const runStore = createMongoMemoryRunStore(client, scope.orgId);
+        const memory = createMemoryCollector({
+            writer,
+            reader,
+            runStore,
+            credentials: createStaticCredentialProvider({
+                // Local ops-source fixture only — values never appear in evidence/HAR bodies.
+                "ops-source-local": { token: "local-acceptance-token" },
+            }),
+            metadata: {
+                resolveSource(sourceId, agentIds) {
+                    const def = metadata.getDefinition(agentIds, "sources", sourceId);
+                    return def?.definition ?? null;
+                },
+            },
+            connectors: {
+                "ops-fixture": createOpsFixtureConnector(),
+                "rest-fixture": createOpsFixtureConnector(),
+            },
+        });
+        const portRegistry = createLivePortRegistry({
+            scope: { orgId: scope.orgId, agentIds: scope.agentIds },
+            collector: memory,
+            writer,
+            reader,
+            relationshipEngine: relationships,
+            honorForceFail: true,
+        });
+        const pipeline = createPipelineRuntime({
+            mode: deps.mode === "prod" ? "prod" : "dev",
+            orgId: scope.orgId,
+            agentIds: scope.agentIds,
+            operationalDb: operationalDbFor(scope.orgId),
+            ledger: pipelineLedgerFor(scope.orgId),
+            ports: portRegistry,
+        });
+        const orgPorts = {
+            catalog,
+            reader,
+            writer,
+            abstractWriter,
+            relationships,
+            memory,
+            pipeline,
+        };
+        portsCache.set(cacheKey, orgPorts);
+        return orgPorts;
+    }
+    return {
+        mode: deps.mode,
+        client,
+        metadata,
+        isolation: deps.isolation ?? null,
+        operationalDbFor,
+        metadataDbFor,
+        pipelineLedgerFor,
+        intelligenceArtifactsFor,
+        portsFor,
+        async close() {
+            if (durableMetadata)
+                await durableMetadata.drain();
+            if (client && !deps.client)
+                await client.close();
+        },
+        diagnostics(scope) {
+            return {
+                mode: deps.mode,
+                scope,
+                hasMongo: Boolean(client),
+                durableMetadata: Boolean(durableMetadata),
+                isolation: deps.isolation
+                    ? {
+                        orgId: deps.isolation.orgId,
+                        metadataDb: deps.isolation.isolatedMetadataDb,
+                        allowed: deps.isolation.allowedDatabaseNames,
+                    }
+                    : null,
+                packages: [
+                    "@x12i/memorix-metadata-runtime",
+                    "@x12i/memorix-mapping",
+                    "@x12i/memorix-data",
+                    "@x12i/memorix-relationships",
+                    "@x12i/memorix-memory",
+                    "@x12i/memorix-pipeline/v2",
+                    "@x12i/memorix-intelligence",
+                ],
+            };
+        },
+    };
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

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

package/dist/relationships/operator-links.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Operator-facing relationship link normalization for Studio / G10 acceptance.
+ * relatedRecordId is always the opposite endpoint of the queried subject.
+ */
+export type OperatorRelationshipLink = {
+    relationshipId: string;
+    relationshipDefinitionId: string;
+    fromRecordId: string;
+    toRecordId: string;
+    relatedRecordId: string;
+    traversal: "forward" | "inverse";
+    targetStatus: "resolved" | "unresolved";
+    target?: unknown;
+    abstractTarget?: unknown;
+    [key: string]: unknown;
+};
+/** Opposite endpoint relative to the queried subject record. */
+export declare function relatedRecordIdForSubject(subjectRecordId: string, fromRecordId: string, toRecordId: string): string;
+export declare function traversalForSubject(subjectRecordId: string, fromRecordId: string, queryTraversal?: "forward" | "inverse"): "forward" | "inverse";
+/** Map data-plane availability to operator vocabulary (resolved | unresolved). */
+export declare function operatorTargetStatus(status: string | undefined): "resolved" | "unresolved";
+export declare function normalizeOperatorRelationshipLink(subjectRecordId: string, item: Record<string, unknown>, queryTraversal?: "forward" | "inverse"): OperatorRelationshipLink;
+//# sourceMappingURL=operator-links.d.ts.map

package/dist/relationships/operator-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-links.d.ts","sourceRoot":"","sources":["../../src/relationships/operator-links.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,wBAAwB,GAAG;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,YAAY,EAAE,UAAU,GAAG,YAAY,CAAC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,SAAS,GAAG,SAAS,GACrC,SAAS,GAAG,SAAS,CAGvB;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,UAAU,GAAG,YAAY,CAI3B;AAED,wBAAgB,iCAAiC,CAC/C,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,CAAC,EAAE,SAAS,GAAG,SAAS,GACrC,wBAAwB,CAoB1B"}

package/dist/relationships/operator-links.js

@@ -0,0 +1,41 @@
+/**
+ * Operator-facing relationship link normalization for Studio / G10 acceptance.
+ * relatedRecordId is always the opposite endpoint of the queried subject.
+ */
+/** Opposite endpoint relative to the queried subject record. */
+export function relatedRecordIdForSubject(subjectRecordId, fromRecordId, toRecordId) {
+    return fromRecordId === subjectRecordId ? toRecordId : fromRecordId;
+}
+export function traversalForSubject(subjectRecordId, fromRecordId, queryTraversal) {
+    if (queryTraversal === "forward" || queryTraversal === "inverse")
+        return queryTraversal;
+    return fromRecordId === subjectRecordId ? "forward" : "inverse";
+}
+/** Map data-plane availability to operator vocabulary (resolved | unresolved). */
+export function operatorTargetStatus(status) {
+    if (status === "unresolved")
+        return "unresolved";
+    if (status === "available" || status === "resolved")
+        return "resolved";
+    return status === "unresolved" ? "unresolved" : "resolved";
+}
+export function normalizeOperatorRelationshipLink(subjectRecordId, item, queryTraversal) {
+    const fromRecordId = String(item.fromRecordId ?? "");
+    const toRecordId = String(item.toRecordId ?? "");
+    const relatedRecordId = relatedRecordIdForSubject(subjectRecordId, fromRecordId, toRecordId);
+    const traversal = traversalForSubject(subjectRecordId, fromRecordId, queryTraversal);
+    const rawStatus = String(item.targetStatus ?? "");
+    return {
+        ...item,
+        relationshipId: String(item.relationshipId ?? ""),
+        relationshipDefinitionId: String(item.relationshipDefinitionId ?? item.definitionId ?? ""),
+        fromRecordId,
+        toRecordId,
+        relatedRecordId,
+        traversal,
+        targetStatus: operatorTargetStatus(rawStatus),
+        target: item.target,
+        abstractTarget: item.abstractTarget,
+    };
+}
+//# sourceMappingURL=operator-links.js.map

package/dist/relationships/operator-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-links.js","sourceRoot":"","sources":["../../src/relationships/operator-links.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,gEAAgE;AAChE,MAAM,UAAU,yBAAyB,CACvC,eAAuB,EACvB,YAAoB,EACpB,UAAkB;IAElB,OAAO,YAAY,KAAK,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,eAAuB,EACvB,YAAoB,EACpB,cAAsC;IAEtC,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IACxF,OAAO,YAAY,KAAK,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAClC,MAA0B;IAE1B,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IACjD,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IACvE,OAAO,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,eAAuB,EACvB,IAA6B,EAC7B,cAAsC;IAEtC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,eAAe,GAAG,yBAAyB,CAAC,eAAe,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAC7F,MAAM,SAAS,GAAG,mBAAmB,CAAC,eAAe,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;IACrF,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO;QACL,GAAG,IAAI;QACP,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;QACjD,wBAAwB,EAAE,MAAM,CAC9B,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CACzD;QACD,YAAY;QACZ,UAAU;QACV,eAAe;QACf,SAAS;QACT,YAAY,EAAE,oBAAoB,CAAC,SAAS,CAAC;QAC7C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC"}

package/dist/request-scope.d.ts

@@ -0,0 +1,7 @@
+import { type MemorixScope } from "./scope.js";
+export declare function resolveScope(req: {
+    headers: Record<string, string | string[] | undefined>;
+    query?: unknown;
+    body?: unknown;
+}): MemorixScope;
+//# sourceMappingURL=request-scope.d.ts.map

package/dist/request-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-scope.d.ts","sourceRoot":"","sources":["../src/request-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGpF,wBAAgB,YAAY,CAAC,GAAG,EAAE;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,YAAY,CAkBf"}

package/dist/request-scope.js

@@ -0,0 +1,24 @@
+import { canonicalizeScope, scopeFromHeaders } from "./scope.js";
+import { ServiceError } from "./errors.js";
+export function resolveScope(req) {
+    const q = (req.query ?? {});
+    const b = (req.body ?? {});
+    try {
+        if (q.orgId || q.agentIds || b.orgId || b.agentIds) {
+            return canonicalizeScope({
+                orgId: (q.orgId ?? b.orgId ?? scopeFromHeaders(req.headers).orgId),
+                agentIds: (q.agentIds ??
+                    b.agentIds ??
+                    scopeFromHeaders(req.headers).agentIds),
+                agentId: q.agentId ?? b.agentId,
+            });
+        }
+        return scopeFromHeaders(req.headers);
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "ScopeValidationError")
+            throw err;
+        throw new ServiceError("SCOPE_INVALID", String(err), 400);
+    }
+}
+//# sourceMappingURL=request-scope.js.map

package/dist/request-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-scope.js","sourceRoot":"","sources":["../src/request-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAqB,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,UAAU,YAAY,CAAC,GAI5B;IACC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;IACvD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IACtD,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnD,OAAO,iBAAiB,CAAC;gBACvB,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAW;gBAC5E,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ;oBACnB,CAAC,CAAC,QAAQ;oBACV,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAsB;gBAC9D,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO;aAChC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB;YAAE,MAAM,GAAG,CAAC;QAC3E,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/routes/data.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { MemorixPlatform } from "../platform.js";
+export declare function registerDataRoutes(app: FastifyInstance, platform: MemorixPlatform): Promise<void>;
+//# sourceMappingURL=data.d.ts.map

package/dist/routes/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/routes/data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAoRf"}