@bett3r-dev/blueprint-schema 1.6.0

package/build/cjs/session.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_STATES = exports.SESSION_SCHEMA_VERSION = void 0;
+exports.isSessionState = isSessionState;
+exports.applySessionEvent = applySessionEvent;
+exports.isSessionFrozen = isSessionFrozen;
+exports.SESSION_SCHEMA_VERSION = 1;
+exports.SESSION_STATES = ['active', 'unanchored', 'frozen'];
+function isSessionState(value) {
+    return typeof value === 'string' && exports.SESSION_STATES.includes(value);
+}
+function withParticipant(participants, actor) {
+    return participants.includes(actor) ? [...participants] : [...participants, actor];
+}
+function applySessionEvent(session, event) {
+    switch (event.type) {
+        case 'attach': {
+            if (session.state === 'frozen')
+                return session;
+            return {
+                ...session,
+                state: 'active',
+                realityProvider: event.provider,
+                realitySha: event.sha,
+                realityAt: event.at,
+                participants: withParticipant(session.participants, event.provider)
+            };
+        }
+        case 'detach': {
+            if (session.state !== 'active')
+                return session;
+            return { ...session, state: 'unanchored', realityAt: event.at };
+        }
+        case 'freeze': {
+            if (session.state === 'frozen')
+                return session;
+            return { ...session, state: 'frozen', frozenFrom: session.state };
+        }
+        case 'reopen': {
+            if (session.state !== 'frozen')
+                return session;
+            const { frozenFrom, ...rest } = session;
+            return { ...rest, state: frozenFrom ?? 'unanchored' };
+        }
+        default: {
+            const unreachable = event;
+            void unreachable;
+            return session;
+        }
+    }
+}
+function isSessionFrozen(session) {
+    return session.state === 'frozen';
+}
+//# sourceMappingURL=session.js.map

package/build/cjs/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":";;;AAeA,wCAEC;AAkCD,8CAgCC;AAED,0CAEC;AAlFY,QAAA,sBAAsB,GAAyB,CAAC,CAAC;AAQjD,QAAA,cAAc,GAA4B,CAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAE,CAAC;AAE5F,SAAgB,cAAc,CAAE,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAM,sBAAqC,CAAC,QAAQ,CAAE,KAAK,CAAE,CAAC;AAChG,CAAC;AA8BD,SAAS,eAAe,CAAE,YAAgC,EAAE,KAAc;IACxE,OAAO,YAAY,CAAC,QAAQ,CAAE,KAAK,CAAE,CAAC,CAAC,CAAC,CAAE,GAAG,YAAY,CAAE,CAAC,CAAC,CAAC,CAAE,GAAG,YAAY,EAAE,KAAK,CAAE,CAAC;AAC3F,CAAC;AAED,SAAgB,iBAAiB,CAAE,OAAsB,EAAE,KAAmB;IAC5E,QAAS,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO;gBACL,GAAG,OAAO;gBACV,KAAK,EAAE,QAAQ;gBACf,eAAe,EAAE,KAAK,CAAC,QAAQ;gBAC/B,UAAU,EAAE,KAAK,CAAC,GAAG;gBACrB,SAAS,EAAE,KAAK,CAAC,EAAE;gBACnB,YAAY,EAAE,eAAe,CAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAE;aACtE,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAClE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACpE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACxC,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,IAAI,YAAY,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,KAAK,CAAC;YACjC,KAAK,WAAW,CAAC;YACjB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAAE,OAAqC;IACpE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC;AACpC,CAAC"}

package/build/cjs/topology.d.ts

@@ -0,0 +1,12 @@
+import { EdgeKind } from './edges.js';
+import { NodeType } from './nodes.js';
+export type TopologyRule = {
+    from: NodeType;
+    kind: EdgeKind;
+    to: NodeType;
+};
+export declare const TOPOLOGY_ALLOWLIST: ReadonlySet<string>;
+export declare const TOPOLOGY_RULES: readonly TopologyRule[];
+export declare function isAllowedEdge(from: NodeType, kind: EdgeKind, to: NodeType): boolean;
+export declare function allowedEdgeKinds(from: NodeType, to: NodeType): readonly EdgeKind[];
+//# sourceMappingURL=topology.d.ts.map

package/build/cjs/topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../src/topology.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;CACd,CAAC;AA0DF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAElD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAc,CAAC;AAEjE,wBAAgB,aAAa,CAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAI,OAAO,CAErF;AAED,wBAAgB,gBAAgB,CAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAI,SAAS,QAAQ,EAAE,CAEpF"}

package/build/cjs/topology.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOPOLOGY_RULES = exports.TOPOLOGY_ALLOWLIST = void 0;
+exports.isAllowedEdge = isAllowedEdge;
+exports.allowedEdgeKinds = allowedEdgeKinds;
+const ARTIFACT_TYPES = [
+    'aggregate',
+    'system',
+    'command',
+    'event',
+    'policy',
+    'read-model'
+];
+const RAW_RULES = [
+    { from: 'command', kind: 'handled-by', to: 'aggregate' },
+    { from: 'command', kind: 'handled-by', to: 'system' },
+    { from: 'command', kind: 'produces', to: 'event' },
+    { from: 'aggregate', kind: 'emits', to: 'event' },
+    { from: 'system', kind: 'emits', to: 'event' },
+    { from: 'event', kind: 'triggers', to: 'policy' },
+    { from: 'policy', kind: 'issues', to: 'command' },
+    { from: 'event', kind: 'causes', to: 'command' },
+    { from: 'ui', kind: 'invokes', to: 'command' },
+    { from: 'ui', kind: 'subscribes-to', to: 'read-model' },
+    { from: 'event', kind: 'projected-to', to: 'read-model' },
+    ...['policy', 'aggregate', 'read-model'].flatMap((from) => ['read-model', 'datastore'].map((to) => ({ from, kind: 'reads-from', to }))),
+    { from: 'postgres-view', kind: 'reads-from', to: 'aggregate' },
+    { from: 'read-model', kind: 'reads-from', to: 'postgres-view' },
+    { from: 'aggregate', kind: 'transactionally-writes-to', to: 'datastore' },
+    { from: 'system', kind: 'transactionally-writes-to', to: 'datastore' },
+    ...['aggregate', 'system', 'policy'].flatMap((from) => ['datastore', 'read-model'].map((to) => ({ from, kind: 'writes-to', to }))),
+    { from: 'system', kind: 'calls', to: 'external-system' },
+    { from: 'policy', kind: 'calls', to: 'external-system' },
+    { from: 'aggregate', kind: 'calls', to: 'external-system' },
+    ...ARTIFACT_TYPES.map((from) => ({ from, kind: 'uses-cache', to: 'cache' }))
+];
+function ruleKey(from, kind, to) {
+    return `${from}|${kind}|${to}`;
+}
+exports.TOPOLOGY_ALLOWLIST = new Set(RAW_RULES.map((r) => ruleKey(r.from, r.kind, r.to)));
+exports.TOPOLOGY_RULES = RAW_RULES;
+function isAllowedEdge(from, kind, to) {
+    return exports.TOPOLOGY_ALLOWLIST.has(ruleKey(from, kind, to));
+}
+function allowedEdgeKinds(from, to) {
+    return RAW_RULES.filter((r) => r.from === from && r.to === to).map((r) => r.kind);
+}
+//# sourceMappingURL=topology.js.map

package/build/cjs/topology.js.map

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

package/build/cjs/validate-design.d.ts

@@ -0,0 +1,22 @@
+import { DesignBatch, DesignFile } from './design.js';
+import { BlueprintGraph } from './graph.js';
+import { BlueprintOverrides } from './overrides.js';
+export type DesignIssueCode = 'UNSUPPORTED_SCHEMA_VERSION' | 'MALFORMED_ENTRY' | 'UNKNOWN_NODE_TYPE' | 'UNKNOWN_EDGE_KIND' | 'UNRESOLVED_EDGE_ENDPOINT' | 'TOPOLOGY_VIOLATION' | 'UNMODIFIABLE_FIELD' | 'UNRESOLVED_TARGET' | 'DUPLICATE_IDENTITY' | 'EDGE_TARGETS_REMOVED' | 'INVALID_EDGE_HANDLER' | 'DUPLICATE_COMMENT_ID';
+export type DesignValidationIssue = {
+    code: DesignIssueCode;
+    path: string;
+    message: string;
+};
+export declare const DESIGN_ISSUE_CLASS: Record<DesignIssueCode, 'malformed' | 'incoherent'>;
+export type DesignValidationResult = {
+    malformed: DesignValidationIssue[];
+    incoherent: DesignValidationIssue[];
+};
+export type ValidateDesignContext = {
+    graph?: BlueprintGraph;
+    incoming?: DesignBatch;
+    overrides?: BlueprintOverrides;
+    mapIds?: ReadonlySet<string>;
+};
+export declare function validateDesign(design: DesignFile, context?: ValidateDesignContext): DesignValidationResult;
+//# sourceMappingURL=validate-design.d.ts.map

package/build/cjs/validate-design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-design.d.ts","sourceRoot":"","sources":["../../src/validate-design.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,WAAW,EAEX,UAAU,EAQX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAU,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAgC,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGlF,MAAM,MAAM,eAAe,GACvB,4BAA4B,GAC5B,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,0BAA0B,GAC1B,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,WAAW,GAAG,YAAY,CAalF,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC,CAAC;AAWF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9B,CAAC;AA0hBF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,qBAA0B,GAClC,sBAAsB,CA6GxB"}