@astrale-os/sdk 0.4.19 → 0.5.0-beta.10

package/dist/linter/policy/configuration.d.ts

@@ -0,0 +1,12 @@
+import type { DomainPolicy, DomainPolicySource } from './index.js';
+export declare const DOMAIN_LINT_CONFIG = "astrale.lint.json";
+export interface DomainLintLayerConfiguration {
+    readonly sourcePath?: string;
+    readonly alias?: string;
+}
+export interface DomainLintConfiguration {
+    readonly layers?: Readonly<Record<string, DomainLintLayerConfiguration>>;
+}
+export declare function compileProjectDomainPolicy(root: string, signal?: AbortSignal): Promise<DomainPolicy>;
+export declare function configureDomainPolicySource(source: DomainPolicySource, configuration: DomainLintConfiguration): DomainPolicySource;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/linter/policy/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/linter/policy/configuration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAMlE,eAAO,MAAM,kBAAkB,sBAAsB,CAAA;AAMrD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAA;CACzE;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,uBAAuB,GACrC,kBAAkB,CAqDpB"}

package/dist/linter/policy/configuration.js

@@ -0,0 +1,119 @@
+import { lstat, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { LinterToolError } from '../diagnostics/index.js';
+import { compileDomainPolicy } from './compile.js';
+import { domainPolicySource } from './generated.js';
+export const DOMAIN_LINT_CONFIG = 'astrale.lint.json';
+const MAX_CONFIG_BYTES = 64 * 1024;
+const SOURCE_PATH = /^[a-z][a-z0-9-]*\/$/;
+const ALIAS = /^#[a-z][a-z0-9-]*$/;
+export async function compileProjectDomainPolicy(root, signal) {
+    const configuration = await readDomainLintConfiguration(root, signal);
+    return compileDomainPolicy(configureDomainPolicySource(domainPolicySource, configuration));
+}
+export function configureDomainPolicySource(source, configuration) {
+    const configuredLayers = configuration.layers ?? {};
+    const knownLayers = new Set(source.layers.map(({ id }) => id));
+    for (const [id, configured] of Object.entries(configuredLayers)) {
+        if (!knownLayers.has(id))
+            invalid(`Unknown Domain lint layer ${id}.`);
+        if (!record(configured))
+            invalid(`Domain lint layer ${id} must be an object.`);
+        const fields = Object.keys(configured);
+        const unknown = fields.filter((field) => field !== 'sourcePath' && field !== 'alias');
+        if (unknown.length > 0) {
+            invalid(`Domain lint layer ${id} has unknown fields: ${unknown.join(', ')}.`);
+        }
+        if (fields.length === 0)
+            invalid(`Domain lint layer ${id} must configure a sourcePath or alias.`);
+        const sourcePath = configured.sourcePath;
+        if (sourcePath !== undefined &&
+            (typeof sourcePath !== 'string' || !SOURCE_PATH.test(sourcePath))) {
+            invalid(`Domain lint layer ${id} sourcePath must be a root directory ending in '/'.`);
+        }
+        const alias = configured.alias;
+        if (alias !== undefined && (typeof alias !== 'string' || !ALIAS.test(alias))) {
+            invalid(`Domain lint layer ${id} alias must be a root # alias without a wildcard.`);
+        }
+    }
+    const layers = source.layers.map((layer) => {
+        const sourcePath = configuredLayers[layer.id]?.sourcePath ?? layer.sourcePath;
+        return Object.freeze({ ...layer, sourcePath });
+    });
+    const sourcePaths = new Map(layers.map(({ id, sourcePath }) => [id, sourcePath]));
+    const aliases = source.aliases.map((alias) => {
+        const configuredPrefix = configuredLayers[alias.layer]?.alias;
+        const specifier = configuredPrefix === undefined
+            ? alias.specifier
+            : alias.kind === 'facade'
+                ? configuredPrefix
+                : `${configuredPrefix}/*`;
+        const sourcePath = sourcePaths.get(alias.layer);
+        const target = alias.kind === 'facade' ? `./${sourcePath}index.ts` : `./${sourcePath}*/index.ts`;
+        return Object.freeze({
+            ...alias,
+            specifier,
+            typescriptTarget: target,
+            packageTarget: target,
+        });
+    });
+    return Object.freeze({
+        ...source,
+        layers: Object.freeze(layers),
+        aliases: Object.freeze(aliases),
+    });
+}
+async function readDomainLintConfiguration(root, signal) {
+    ensureActive(signal);
+    const path = join(root, DOMAIN_LINT_CONFIG);
+    let metadata;
+    try {
+        metadata = await lstat(path);
+    }
+    catch (cause) {
+        if (cause.code === 'ENOENT')
+            return Object.freeze({});
+        invalid(`Cannot inspect Domain lint configuration ${path}.`, cause);
+    }
+    if (metadata.isSymbolicLink() || !metadata.isFile()) {
+        invalid(`Domain lint configuration must be a regular file: ${path}.`);
+    }
+    if (metadata.size > MAX_CONFIG_BYTES) {
+        invalid(`Domain lint configuration ${path} is ${metadata.size} bytes; maximum is ${MAX_CONFIG_BYTES}.`);
+    }
+    ensureActive(signal);
+    let value;
+    try {
+        const bytes = await readFile(path);
+        const text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+        value = JSON.parse(text);
+    }
+    catch (cause) {
+        invalid(`Cannot parse Domain lint configuration ${path}.`, cause);
+    }
+    if (!record(value))
+        invalid('Domain lint configuration must be an object.');
+    const unknown = Object.keys(value).filter((field) => field !== 'layers');
+    if (unknown.length > 0) {
+        invalid(`Domain lint configuration has unknown fields: ${unknown.join(', ')}.`);
+    }
+    if (value.layers !== undefined && !record(value.layers)) {
+        invalid('Domain lint configuration layers must be an object.');
+    }
+    return value;
+}
+function ensureActive(signal) {
+    if (signal?.aborted) {
+        throw new LinterToolError('Domain lint was cancelled.', {
+            code: 'LINTER_CANCELLED',
+            cause: signal.reason,
+        });
+    }
+}
+function invalid(message, cause) {
+    throw new LinterToolError(message, { code: 'LINTER_PROJECT_INVALID', cause });
+}
+function record(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+//# sourceMappingURL=configuration.js.map

package/dist/linter/policy/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/linter/policy/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAA;AAErD,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAA;AAClC,MAAM,WAAW,GAAG,qBAAqB,CAAA;AACzC,MAAM,KAAK,GAAG,oBAAoB,CAAA;AAWlC,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAY,EACZ,MAAoB;IAEpB,MAAM,aAAa,GAAG,MAAM,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrE,OAAO,mBAAmB,CAAC,2BAA2B,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAA;AAC5F,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAA0B,EAC1B,aAAsC;IAEtC,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,IAAI,EAAE,CAAA;IACnD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC9D,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;QACrE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAA;QAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,OAAO,CAAC,CAAA;QACrF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,qBAAqB,EAAE,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC/E,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YACrB,OAAO,CAAC,qBAAqB,EAAE,wCAAwC,CAAC,CAAA;QAC1E,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAA;QACxC,IACE,UAAU,KAAK,SAAS;YACxB,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EACjE,CAAC;YACD,OAAO,CAAC,qBAAqB,EAAE,qDAAqD,CAAC,CAAA;QACvF,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAA;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7E,OAAO,CAAC,qBAAqB,EAAE,mDAAmD,CAAC,CAAA;QACrF,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACzC,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC,UAAU,CAAA;QAC7E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IACjF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;QAC7D,MAAM,SAAS,GACb,gBAAgB,KAAK,SAAS;YAC5B,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;gBACvB,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,GAAG,gBAAgB,IAAI,CAAA;QAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAE,CAAA;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,UAAU,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,YAAY,CAAA;QAChG,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,KAAK;YACR,SAAS;YACT,gBAAgB,EAAE,MAAM;YACxB,aAAa,EAAE,MAAM;SACtB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,MAAM;QACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;KAChC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,IAAY,EACZ,MAAoB;IAEpB,YAAY,CAAC,MAAM,CAAC,CAAA;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAA;IAC3C,IAAI,QAAQ,CAAA;IACZ,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAChF,OAAO,CAAC,4CAA4C,IAAI,GAAG,EAAE,KAAK,CAAC,CAAA;IACrE,CAAC;IACD,IAAI,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACpD,OAAO,CAAC,qDAAqD,IAAI,GAAG,CAAC,CAAA;IACvE,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,GAAG,gBAAgB,EAAE,CAAC;QACrC,OAAO,CACL,6BAA6B,IAAI,OAAO,QAAQ,CAAC,IAAI,sBAAsB,gBAAgB,GAAG,CAC/F,CAAA;IACH,CAAC;IACD,YAAY,CAAC,MAAM,CAAC,CAAA;IACpB,IAAI,KAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACpE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,0CAA0C,IAAI,GAAG,EAAE,KAAK,CAAC,CAAA;IACnE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,8CAA8C,CAAC,CAAA;IAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAA;IACxE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,iDAAiD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,qDAAqD,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,KAAgC,CAAA;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,MAA+B;IACnD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CAAC,4BAA4B,EAAE;YACtD,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,KAAe;IAC/C,MAAM,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,CAAA;AAC/E,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;AAC7E,CAAC"}

package/dist/linter/policy/generated.d.ts

@@ -0,0 +1,5 @@
+import type { DomainPolicySource } from './index.js';
+/** Generated from the validated Domain knowledge catalog. Do not edit by hand. */
+export declare const domainPolicyDigest: string;
+export declare const domainPolicySource: DomainPolicySource;
+//# sourceMappingURL=generated.d.ts.map

package/dist/linter/policy/generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../../src/linter/policy/generated.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,EAAE,MACmC,CAAA;AAEpE,eAAO,MAAM,kBAAkB,EAAE,kBAkwB/B,CAAA"}