@mouryaamit/nx-polystack 0.0.0-stage → 1.0.1

package/dist/src/lib/utils/base-href.d.ts

@@ -0,0 +1,26 @@
+type Target = {
+    executor?: string;
+    options?: Record<string, unknown>;
+    configurations?: Record<string, Record<string, unknown>>;
+};
+/**
+ * A base href is a path: "/" or "/seg/…/seg/" with URL-safe segments (letters, digits, . _ ~ % -).
+ * No host (`//x/`), no `..`, nothing a shell would read (it ends up on the build command line).
+ */
+export declare function checkBaseHref(href: string): string;
+/**
+ * The target whose configurations carry the base href: the polystack release target of an
+ * Angular/Ionic app, else a Flutter app's build-web.
+ */
+export declare function baseHrefTarget(projectJson: Record<string, unknown>): {
+    name: string;
+    target: Target;
+} | undefined;
+/**
+ * Whether a configuration builds DEV: its env, else the target's env option, else the executor's
+ * default (dev for Flutter builds), else its name.
+ */
+export declare function isDevConfiguration(target: Target, name: string): boolean;
+/** Sets (or, with undefined, removes) baseHref on the given configurations; returns their names. */
+export declare function setBaseHref(target: Target, configurations: string[], href: string | undefined): string[];
+export {};

package/dist/src/lib/utils/base-href.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setBaseHref = exports.isDevConfiguration = exports.baseHrefTarget = exports.checkBaseHref = void 0;
+const angular_project_1 = require("./angular-project");
+const FLUTTER_BUILD_EXECUTOR = '@mouryaamit/nx-polystack:flutter-build';
+/**
+ * A base href is a path: "/" or "/seg/…/seg/" with URL-safe segments (letters, digits, . _ ~ % -).
+ * No host (`//x/`), no `..`, nothing a shell would read (it ends up on the build command line).
+ */
+function checkBaseHref(href) {
+    const ok = /^\/(?:[A-Za-z0-9._~%-]+\/)*$/.test(href) &&
+        !href.split('/').some((s) => s === '..' || s === '.');
+    if (!ok) {
+        throw new Error(`base href "${href}" must start and end with "/" and hold only letters, digits, . _ ~ % - ` +
+            'between the slashes (e.g. /portal/)');
+    }
+    return href;
+}
+exports.checkBaseHref = checkBaseHref;
+/**
+ * The target whose configurations carry the base href: the polystack release target of an
+ * Angular/Ionic app, else a Flutter app's build-web.
+ */
+function baseHrefTarget(projectJson) {
+    const targets = (projectJson['targets'] ?? {});
+    const release = Object.entries(targets).find(([, t]) => t.executor === angular_project_1.POLYSTACK_BUILD_EXECUTOR);
+    if (release)
+        return { name: release[0], target: release[1] };
+    const web = targets['build-web'];
+    if (web?.executor === FLUTTER_BUILD_EXECUTOR)
+        return { name: 'build-web', target: web };
+    return undefined;
+}
+exports.baseHrefTarget = baseHrefTarget;
+/**
+ * Whether a configuration builds DEV: its env, else the target's env option, else the executor's
+ * default (dev for Flutter builds), else its name.
+ */
+function isDevConfiguration(target, name) {
+    const env = target.configurations?.[name]?.['env'] ??
+        target.options?.['env'] ??
+        (target.executor === FLUTTER_BUILD_EXECUTOR ? 'dev' : name);
+    return ['dev', 'development'].includes(String(env).toLowerCase());
+}
+exports.isDevConfiguration = isDevConfiguration;
+/** Sets (or, with undefined, removes) baseHref on the given configurations; returns their names. */
+function setBaseHref(target, configurations, href) {
+    target.configurations ??= {};
+    for (const name of configurations) {
+        const conf = { ...(target.configurations[name] ?? {}) };
+        if (href === undefined)
+            delete conf['baseHref'];
+        else
+            conf['baseHref'] = href;
+        target.configurations[name] = conf;
+    }
+    return configurations;
+}
+exports.setBaseHref = setBaseHref;
+//# sourceMappingURL=base-href.js.map

package/dist/src/lib/utils/base-href.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-href.js","sourceRoot":"","sources":["../../../../src/lib/utils/base-href.ts"],"names":[],"mappings":";;;AAAA,uDAA6D;AAE7D,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;AAQxE;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,EAAE,GACN,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,EAAE;QACP,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,yEAAyE;YACzF,qCAAqC,CACxC,CAAC;KACH;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAXD,sCAWC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,WAAoC;IAEpC,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,CAA2B,CAAC;IACzE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,0CAAwB,CAAC,CAAC;IACjG,IAAI,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,GAAG,EAAE,QAAQ,KAAK,sBAAsB;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACxF,OAAO,SAAS,CAAC;AACnB,CAAC;AATD,wCASC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAAc,EAAE,IAAY;IAC7D,MAAM,GAAG,GACP,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC;QACtC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC;QACvB,CAAC,MAAM,CAAC,QAAQ,KAAK,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACpE,CAAC;AAND,gDAMC;AAED,oGAAoG;AACpG,SAAgB,WAAW,CACzB,MAAc,EACd,cAAwB,EACxB,IAAwB;IAExB,MAAM,CAAC,cAAc,KAAK,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE;QACjC,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC;;YAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KACpC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAbD,kCAaC"}

package/dist/src/lib/utils/ci-resolve.d.ts

@@ -0,0 +1,10 @@
+export interface CiContext {
+    branch: string;
+    commit: string;
+    buildNumber: string;
+}
+export interface CiContextOptions {
+    /** Override how git is invoked (for tests). Returns trimmed stdout, or null on failure. */
+    git?: (cmd: string) => string | null;
+}
+export declare function resolveCiContext(opts?: CiContextOptions): CiContext;

package/dist/src/lib/utils/ci-resolve.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCiContext = void 0;
+const child_process_1 = require("child_process");
+const defaultGit = (cmd) => {
+    try {
+        return ((0, child_process_1.execSync)(cmd, { stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim() || null);
+    }
+    catch {
+        return null;
+    }
+};
+const stripBranchPrefixes = (b) => b
+    .replace(/^origin\//, '')
+    .replace(/^refs\/heads\//, '')
+    .replace(/^remotes\//, '');
+function resolveCiContext(opts = {}) {
+    const git = opts.git ?? defaultGit;
+    let branch = process.env['BUILD_BRANCH'] ||
+        process.env['BRANCH_NAME'] ||
+        process.env['GIT_BRANCH'] ||
+        process.env['CHANGE_BRANCH'] ||
+        process.env['GITHUB_HEAD_REF'] ||
+        process.env['GITHUB_REF_NAME'] ||
+        process.env['CI_COMMIT_REF_NAME'] ||
+        process.env['BITBUCKET_BRANCH'] ||
+        process.env['CIRCLE_BRANCH'] ||
+        process.env['BUILD_SOURCEBRANCHNAME'] ||
+        git('git rev-parse --abbrev-ref HEAD') ||
+        'unknown';
+    if (branch === 'HEAD') {
+        branch = git('git name-rev --name-only HEAD') || 'unknown';
+    }
+    branch = stripBranchPrefixes(branch);
+    const ciCommit = process.env['BUILD_COMMIT'] ||
+        process.env['GIT_COMMIT'] ||
+        process.env['GITHUB_SHA'] ||
+        process.env['CI_COMMIT_SHA'] ||
+        process.env['BITBUCKET_COMMIT'] ||
+        process.env['CIRCLE_SHA1'] ||
+        process.env['BUILD_SOURCEVERSION'];
+    // Used as given: the encryption key and the meta tag take the same value, so they always match.
+    const commit = ciCommit || git('git rev-parse --short HEAD') || 'unknown';
+    const buildNumber = process.env['BUILD_NUMBER'] || process.env['BUILD_ID'] || String(Date.now());
+    return { branch, commit, buildNumber };
+}
+exports.resolveCiContext = resolveCiContext;
+//# sourceMappingURL=ci-resolve.js.map

package/dist/src/lib/utils/ci-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-resolve.js","sourceRoot":"","sources":["../../../../src/lib/utils/ci-resolve.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AAazC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAiB,EAAE;IAChD,IAAI;QACF,OAAO,CACL,IAAA,wBAAQ,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;aACnD,QAAQ,EAAE;aACV,IAAI,EAAE,IAAI,IAAI,CAClB,CAAC;KACH;IAAC,MAAM;QACN,OAAO,IAAI,CAAC;KACb;AACH,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAS,EAAU,EAAE,CAChD,CAAC;KACE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;KACxB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;KAC7B,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAE/B,SAAgB,gBAAgB,CAAC,OAAyB,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC;IAEnC,IAAI,MAAM,GACR,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;QACrC,GAAG,CAAC,iCAAiC,CAAC;QACtC,SAAS,CAAC;IAEZ,IAAI,MAAM,KAAK,MAAM,EAAE;QACrB,MAAM,GAAG,GAAG,CAAC,+BAA+B,CAAC,IAAI,SAAS,CAAC;KAC5D;IACD,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErC,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACrC,gGAAgG;IAChG,MAAM,MAAM,GAAG,QAAQ,IAAI,GAAG,CAAC,4BAA4B,CAAC,IAAI,SAAS,CAAC;IAE1E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACzC,CAAC;AApCD,4CAoCC"}

package/dist/src/lib/utils/csp-nonce.d.ts

@@ -0,0 +1,34 @@
+import { Tree } from '@nx/devkit';
+/** The library's runtime CSP nonce patch (see runtime/csp-nonce.js). */
+export declare const CSP_NONCE_IMPORT = "@mouryaamit/nx-polystack/runtime/csp-nonce";
+export declare const hasCspNonceImport: (text: string) => boolean;
+/**
+ * `text` with the library import as its first statement (unchanged when already there). It goes
+ * after a shebang and `/// <reference …>` directives, which only count before any statement.
+ */
+export declare function withCspNonceImport(text: string): string;
+export interface NoncePatchSwap {
+    /** The new main.ts text. */
+    text: string;
+    /** Local nonce patch imports replaced by the library's (specifiers as written). */
+    replaced: string[];
+    /** Local nonce patch imports kept (the library import was added before them). */
+    kept: string[];
+}
+export interface NoncePatchOptions {
+    /** Replace compatible local patches (`:migrate`); false keeps every local import. */
+    replaceLocal: boolean;
+}
+/**
+ * main.ts (`file`, workspace-relative) with the library nonce patch: a compatible local patch
+ * import is replaced in place; otherwise the library import is added first and local ones stay.
+ * `read` returns a workspace file (or undefined).
+ */
+export declare function useLibraryNoncePatch(file: string, text: string, read: (workspacePath: string) => string | undefined, opts?: NoncePatchOptions): NoncePatchSwap;
+/** Applies useLibraryNoncePatch to a main.ts in the tree. */
+export declare function patchMainInTree(tree: Tree, mainFile: string, opts?: NoncePatchOptions): NoncePatchSwap | undefined;
+/**
+ * Patches the main.ts of migrated apps and returns the report note (undefined when nothing
+ * changed). `mains` are workspace paths.
+ */
+export declare function noncePatchMains(tree: Tree, mains: string[]): string | undefined;

package/dist/src/lib/utils/csp-nonce.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noncePatchMains = exports.patchMainInTree = exports.useLibraryNoncePatch = exports.withCspNonceImport = exports.hasCspNonceImport = exports.CSP_NONCE_IMPORT = void 0;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+/** The library's runtime CSP nonce patch (see runtime/csp-nonce.js). */
+exports.CSP_NONCE_IMPORT = '@mouryaamit/nx-polystack/runtime/csp-nonce';
+const IMPORT_LINE = `import '${exports.CSP_NONCE_IMPORT}';`;
+const COMMENT = "// Gives <script>/<style> elements added at runtime the page's CSP nonce (keep it first).";
+/** Side-effect imports: `import './x';` (one per line). */
+const SIDE_EFFECT = /^[ \t]*import[ \t]+(['"])([^'"]+)\1[ \t]*;?[ \t]*(\/\/.*)?$/gm;
+const hasCspNonceImport = (text) => text.includes(exports.CSP_NONCE_IMPORT);
+exports.hasCspNonceImport = hasCspNonceImport;
+/**
+ * `text` with the library import as its first statement (unchanged when already there). It goes
+ * after a shebang and `/// <reference …>` directives, which only count before any statement.
+ */
+function withCspNonceImport(text) {
+    if ((0, exports.hasCspNonceImport)(text))
+        return text;
+    const lines = text.split('\n');
+    // After the last shebang or `///` directive of the leading block of comments and blank lines.
+    let at = 0;
+    let inBlock = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (inBlock) {
+            if (line.includes('*/'))
+                inBlock = false;
+            continue;
+        }
+        if (/^#!/.test(line) || /^\/\/\/\s*</.test(line))
+            at = i + 1;
+        else if (line.startsWith('/*'))
+            inBlock = !line.includes('*/');
+        else if (!(line === '' || line.startsWith('//')))
+            break;
+    }
+    const head = lines.slice(0, at);
+    const rest = lines.slice(at).join('\n');
+    const block = `${COMMENT}\n${IMPORT_LINE}\n${rest.startsWith('\n') || rest === '' ? '' : '\n'}`;
+    return head.length > 0 ? `${head.join('\n')}\n${block}${rest}` : `${block}${rest}`;
+}
+exports.withCspNonceImport = withCspNonceImport;
+const RESOLVE_SUFFIXES = ['', '.ts', '.js', '.mjs', '/index.ts', '/index.js'];
+/**
+ * What a local side-effect import is:
+ * - `compatible`: a nonce patch that reads the nonce where the library does
+ *   (`window.__cspNonce` or the csp-nonce meta tag), so the library can replace it;
+ * - `other`: a nonce patch that reads it some other way (or can't be read), kept as is;
+ * - `none`: not a nonce patch.
+ */
+function noncePatchKind(spec, text) {
+    if (text === undefined) {
+        return /csp[-_]?nonce|nonce[-_]?patch/i.test(path.posix.basename(spec)) ? 'other' : 'none';
+    }
+    if (!/nonce/i.test(text) || !/(appendChild|insertBefore)/.test(text))
+        return 'none';
+    return /__cspNonce|csp-nonce/i.test(text) ? 'compatible' : 'other';
+}
+/**
+ * main.ts (`file`, workspace-relative) with the library nonce patch: a compatible local patch
+ * import is replaced in place; otherwise the library import is added first and local ones stay.
+ * `read` returns a workspace file (or undefined).
+ */
+function useLibraryNoncePatch(file, text, read, opts = { replaceLocal: true }) {
+    const replaced = [];
+    const kept = [];
+    let swapped = text.replace(SIDE_EFFECT, (line, _q, spec) => {
+        if (!spec.startsWith('.'))
+            return line;
+        const base = path.posix.normalize(path.posix.join(path.posix.dirname(file), spec));
+        const target = RESOLVE_SUFFIXES.map((s) => base + s).find((p) => read(p) !== undefined);
+        const kind = noncePatchKind(spec, target ? read(target) : undefined);
+        if (kind === 'none')
+            return line;
+        if (kind === 'other' || !opts.replaceLocal || (0, exports.hasCspNonceImport)(text)) {
+            kept.push(spec);
+            return line;
+        }
+        replaced.push(spec);
+        return replaced.length === 1 ? `${IMPORT_LINE} // was '${spec}'` : `// was: ${line.trim()}`;
+    });
+    // A replaced import stays where the local patch was imported (normally first).
+    if (replaced.length === 0)
+        swapped = withCspNonceImport(swapped);
+    return { text: swapped, replaced, kept };
+}
+exports.useLibraryNoncePatch = useLibraryNoncePatch;
+/** Applies useLibraryNoncePatch to a main.ts in the tree. */
+function patchMainInTree(tree, mainFile, opts) {
+    if (!tree.exists(mainFile))
+        return undefined;
+    const text = tree.read(mainFile, 'utf8') ?? '';
+    const result = useLibraryNoncePatch(mainFile, text, (p) => (tree.exists(p) && tree.isFile(p) ? tree.read(p, 'utf8') ?? '' : undefined), opts);
+    if (result.text !== text)
+        tree.write(mainFile, result.text);
+    return result;
+}
+exports.patchMainInTree = patchMainInTree;
+const code = (s) => `\`${s}\``;
+/**
+ * Patches the main.ts of migrated apps and returns the report note (undefined when nothing
+ * changed). `mains` are workspace paths.
+ */
+function noncePatchMains(tree, mains) {
+    const added = [];
+    const swapped = [];
+    const keptLocal = [];
+    for (const main of mains) {
+        const before = tree.exists(main) ? tree.read(main, 'utf8') : undefined;
+        const result = patchMainInTree(tree, main, { replaceLocal: true });
+        if (result === undefined)
+            continue;
+        if (result.kept.length > 0) {
+            keptLocal.push(`${code(main)} (${result.kept.map(code).join(', ')})`);
+        }
+        if (tree.read(main, 'utf8') === before)
+            continue;
+        if (result.replaced.length > 0) {
+            swapped.push(`${code(main)} (was ${result.replaced.map(code).join(', ')})`);
+        }
+        else
+            added.push(code(main));
+    }
+    const parts = [];
+    if (swapped.length > 0) {
+        parts.push(`the local CSP nonce patch import was replaced by ${code(exports.CSP_NONCE_IMPORT)} in ` +
+            `${swapped.join(', ')}; the local file stays where it was copied, delete it once ` +
+            'nothing imports it');
+    }
+    if (added.length > 0) {
+        parts.push(`${code(exports.CSP_NONCE_IMPORT)} was added first in ${added.join(', ')} (it gives runtime ` +
+            '<script>/<style> elements the page CSP nonce; without a nonce it does nothing)');
+    }
+    if (keptLocal.length > 0) {
+        parts.push(`local nonce patches that read the nonce some other way were kept in ${keptLocal.join(', ')}; check whether the library patch can replace them`);
+    }
+    return parts.length > 0 ? `CSP nonce: ${parts.join('; ')}.` : undefined;
+}
+exports.noncePatchMains = noncePatchMains;
+//# sourceMappingURL=csp-nonce.js.map

package/dist/src/lib/utils/csp-nonce.js.map

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

package/dist/src/lib/utils/dependencies.d.ts

@@ -0,0 +1,25 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+export type Deps = Record<string, string>;
+/** Major version of a semver-ish range ("~15.2.0" → 15); undefined when it can't be read. */
+export declare function majorOf(version: string): number | undefined;
+/** Version declared for `name` in dependencies or devDependencies. */
+export declare function declaredVersion(tree: Tree, name: string): string | undefined;
+/**
+ * The workspace's nx version, for the @nx/* packages that must match it exactly: the installed
+ * version from node_modules when present, else the declared range, else ^17.0.0.
+ */
+export declare function nxVersion(tree: Tree): string;
+/**
+ * Adds only the packages that are not declared yet (in either field) and never changes an
+ * existing version. Returns the install callback, or undefined when nothing was added.
+ */
+export declare function addMissingDependencies(tree: Tree, deps: Deps, devDeps: Deps): GeneratorCallback | undefined;
+/** ESLint stack every workspace needs for the root .eslintrc.json (same versions as the sample). */
+export declare function lintDependencies(nx: string): Deps;
+export declare function ensureLintDependencies(tree: Tree): GeneratorCallback | undefined;
+/** terser: loaded from the workspace by the release target's comment and console stripping. */
+export declare const RELEASE_HARDENING_DEV_DEPENDENCIES: Deps;
+export declare function ensureReleaseHardeningDependencies(tree: Tree): GeneratorCallback | undefined;
+/** javascript-obfuscator: loaded from the workspace by the release target's obfuscate step. */
+export declare const OBFUSCATION_DEV_DEPENDENCIES: Deps;
+export declare function ensureObfuscationDependencies(tree: Tree): GeneratorCallback | undefined;

package/dist/src/lib/utils/dependencies.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureObfuscationDependencies = exports.OBFUSCATION_DEV_DEPENDENCIES = exports.ensureReleaseHardeningDependencies = exports.RELEASE_HARDENING_DEV_DEPENDENCIES = exports.ensureLintDependencies = exports.lintDependencies = exports.addMissingDependencies = exports.nxVersion = exports.declaredVersion = exports.majorOf = void 0;
+const devkit_1 = require("@nx/devkit");
+/** Major version of a semver-ish range ("~15.2.0" → 15); undefined when it can't be read. */
+function majorOf(version) {
+    const m = /^\D*(\d+)(?:[.\s]|$)/.exec(version.trim());
+    return m ? Number(m[1]) : undefined;
+}
+exports.majorOf = majorOf;
+/** Version declared for `name` in dependencies or devDependencies. */
+function declaredVersion(tree, name) {
+    const pkg = (0, devkit_1.readJson)(tree, 'package.json');
+    return pkg.dependencies?.[name] ?? pkg.devDependencies?.[name];
+}
+exports.declaredVersion = declaredVersion;
+/**
+ * The workspace's nx version, for the @nx/* packages that must match it exactly: the installed
+ * version from node_modules when present, else the declared range, else ^17.0.0.
+ */
+function nxVersion(tree) {
+    if (tree.exists('node_modules/nx/package.json')) {
+        const installed = (0, devkit_1.readJson)(tree, 'node_modules/nx/package.json').version;
+        if (typeof installed === 'string')
+            return installed;
+    }
+    return declaredVersion(tree, 'nx') ?? '^17.0.0';
+}
+exports.nxVersion = nxVersion;
+/**
+ * Adds only the packages that are not declared yet (in either field) and never changes an
+ * existing version. Returns the install callback, or undefined when nothing was added.
+ */
+function addMissingDependencies(tree, deps, devDeps) {
+    const missing = (wanted) => Object.fromEntries(Object.entries(wanted).filter(([name]) => declaredVersion(tree, name) === undefined));
+    const d = missing(deps);
+    const dd = missing(devDeps);
+    if (Object.keys(d).length === 0 && Object.keys(dd).length === 0)
+        return undefined;
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, d, dd);
+}
+exports.addMissingDependencies = addMissingDependencies;
+/** ESLint stack every workspace needs for the root .eslintrc.json (same versions as the sample). */
+function lintDependencies(nx) {
+    return {
+        eslint: '^8.57.0',
+        '@nx/eslint': nx,
+        '@nx/eslint-plugin': nx,
+        '@typescript-eslint/eslint-plugin': '^5.62.0',
+        '@typescript-eslint/parser': '^5.62.0',
+        'eslint-config-prettier': '^9.1.0',
+    };
+}
+exports.lintDependencies = lintDependencies;
+function ensureLintDependencies(tree) {
+    return addMissingDependencies(tree, {}, lintDependencies(nxVersion(tree)));
+}
+exports.ensureLintDependencies = ensureLintDependencies;
+/** terser: loaded from the workspace by the release target's comment and console stripping. */
+exports.RELEASE_HARDENING_DEV_DEPENDENCIES = { terser: '^5.16.0' };
+function ensureReleaseHardeningDependencies(tree) {
+    return addMissingDependencies(tree, {}, exports.RELEASE_HARDENING_DEV_DEPENDENCIES);
+}
+exports.ensureReleaseHardeningDependencies = ensureReleaseHardeningDependencies;
+/** javascript-obfuscator: loaded from the workspace by the release target's obfuscate step. */
+exports.OBFUSCATION_DEV_DEPENDENCIES = { 'javascript-obfuscator': '^4.2.2' };
+function ensureObfuscationDependencies(tree) {
+    return addMissingDependencies(tree, {}, exports.OBFUSCATION_DEV_DEPENDENCIES);
+}
+exports.ensureObfuscationDependencies = ensureObfuscationDependencies;
+//# sourceMappingURL=dependencies.js.map

package/dist/src/lib/utils/dependencies.js.map

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

package/dist/src/lib/utils/devkit-deps.d.ts

@@ -0,0 +1,19 @@
+/** The parts of `semver` we use (typed here so the build needs no @types/semver). */
+interface Semver {
+    validRange(range: string): string | null;
+    intersects(a: string, b: string): boolean;
+}
+/** The parts of `ignore` we use. */
+export interface Ignore {
+    add(patterns: string): Ignore;
+    ignores(pathname: string): boolean;
+}
+export declare const semver: Semver;
+export declare const createIgnore: () => Ignore;
+/**
+ * True when two version specs can be satisfied together. Ranges that semver understands are
+ * compared by intersection (`^15.2.0` and `~15.2.0` overlap); anything else (tags, URLs, `file:`)
+ * only matches when the strings are equal.
+ */
+export declare function rangesOverlap(a: string, b: string): boolean;
+export {};

package/dist/src/lib/utils/devkit-deps.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rangesOverlap = exports.createIgnore = exports.semver = void 0;
+const module_1 = require("module");
+/**
+ * `semver` and `ignore` are direct dependencies of @nx/devkit (our peer). Resolving them through
+ * @nx/devkit works with hoisted (npm) and strict (pnpm) node_modules layouts alike, without the
+ * plugin declaring its own copies.
+ */
+const fromDevkit = (0, module_1.createRequire)(require.resolve('@nx/devkit/package.json'));
+exports.semver = fromDevkit('semver');
+const ignoreModule = fromDevkit('ignore');
+exports.createIgnore = ignoreModule.default ?? ignoreModule;
+/**
+ * True when two version specs can be satisfied together. Ranges that semver understands are
+ * compared by intersection (`^15.2.0` and `~15.2.0` overlap); anything else (tags, URLs, `file:`)
+ * only matches when the strings are equal.
+ */
+function rangesOverlap(a, b) {
+    if (a === b)
+        return true;
+    const ra = exports.semver.validRange(a);
+    const rb = exports.semver.validRange(b);
+    if (!ra || !rb)
+        return false;
+    try {
+        return exports.semver.intersects(ra, rb);
+    }
+    catch {
+        return false;
+    }
+}
+exports.rangesOverlap = rangesOverlap;
+//# sourceMappingURL=devkit-deps.js.map

package/dist/src/lib/utils/devkit-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devkit-deps.js","sourceRoot":"","sources":["../../../../src/lib/utils/devkit-deps.ts"],"names":[],"mappings":";;;AAAA,mCAAuC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,GAAG,IAAA,sBAAa,EAAC,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC;AAchE,QAAA,MAAM,GAAW,UAAU,CAAC,QAAQ,CAAC,CAAC;AACnD,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC7B,QAAA,YAAY,GAAiB,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC;AAE/E;;;;GAIG;AACH,SAAgB,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,EAAE,GAAG,cAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,cAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI;QACF,OAAO,cAAM,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;KAClC;IAAC,MAAM;QACN,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAVD,sCAUC"}

package/dist/src/lib/utils/env-files.d.ts

@@ -0,0 +1,18 @@
+import { Tree } from '@nx/devkit';
+import { EnvLayout } from './angular-project';
+/**
+ * environments/<app>/environment.ts (dev), .uat.ts and .prod.ts; in the per-env layout
+ * environment.dev.ts instead of environment.ts, plus the shared environments/environment.ts
+ * (created when missing) that the app imports and its build configurations replace.
+ */
+export declare function generateAngularEnvFiles(tree: Tree, projectName: string, layout?: EnvLayout): void;
+export interface FlutterEnvFilesOptions {
+    /** Leave env/<env>.json files that already exist in the tree as they are. */
+    keepExisting?: boolean;
+    /** Write `{}` instead of the example values (for apps with their own configuration). */
+    empty?: boolean;
+    /** Project root (default apps/<name>). */
+    root?: string;
+}
+/** apps/<name>/env/{dev,uat,prod}.json; returns the files written. */
+export declare function generateFlutterEnvFiles(tree: Tree, projectName: string, opts?: FlutterEnvFilesOptions): string[];

package/dist/src/lib/utils/env-files.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFlutterEnvFiles = exports.generateAngularEnvFiles = void 0;
+const angular_project_1 = require("./angular-project");
+/**
+ * environments/<app>/environment.ts (dev), .uat.ts and .prod.ts; in the per-env layout
+ * environment.dev.ts instead of environment.ts, plus the shared environments/environment.ts
+ * (created when missing) that the app imports and its build configurations replace.
+ */
+function generateAngularEnvFiles(tree, projectName, layout = 'default') {
+    const base = `environments/${projectName}`;
+    tree.write(layout === 'per-env' ? `${base}/environment.dev.ts` : `${base}/environment.ts`, `export const environment = {\n  production: false,\n  envName: 'dev',\n};\n`);
+    tree.write(`${base}/environment.uat.ts`, `export const environment = {\n  production: false,\n  envName: 'uat',\n};\n`);
+    tree.write(`${base}/environment.prod.ts`, `export const environment = {\n  production: true,\n  envName: 'prod',\n};\n`);
+    if (layout === 'per-env' && !tree.exists(angular_project_1.PER_ENV_ROOT_FILE)) {
+        tree.write(angular_project_1.PER_ENV_ROOT_FILE, "// Replaced at build time by each app's environments/<app>/environment.<env>.ts\n" +
+            '// (fileReplacements in its project.json). Only the shape matters here.\n' +
+            `export const environment = {\n  production: false,\n  envName: 'dev',\n};\n`);
+    }
+}
+exports.generateAngularEnvFiles = generateAngularEnvFiles;
+/** apps/<name>/env/{dev,uat,prod}.json; returns the files written. */
+function generateFlutterEnvFiles(tree, projectName, opts = {}) {
+    const base = `${opts.root ?? `apps/${projectName}`}/env`;
+    const files = {
+        dev: { FLUTTER_ENV: 'dev', API_BASE_URL: 'https://dev.example.com' },
+        uat: { FLUTTER_ENV: 'uat', API_BASE_URL: 'https://uat.example.com' },
+        prod: { FLUTTER_ENV: 'prod', API_BASE_URL: 'https://example.com' },
+    };
+    const written = [];
+    for (const [env, content] of Object.entries(files)) {
+        const file = `${base}/${env}.json`;
+        if (opts.keepExisting && tree.exists(file))
+            continue;
+        tree.write(file, opts.empty ? '{}\n' : JSON.stringify(content, null, 2) + '\n');
+        written.push(file);
+    }
+    return written;
+}
+exports.generateFlutterEnvFiles = generateFlutterEnvFiles;
+//# sourceMappingURL=env-files.js.map

package/dist/src/lib/utils/env-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-files.js","sourceRoot":"","sources":["../../../../src/lib/utils/env-files.ts"],"names":[],"mappings":";;;AAEA,uDAAiE;AAEjE;;;;GAIG;AACH,SAAgB,uBAAuB,CACrC,IAAU,EACV,WAAmB,EACnB,SAAoB,SAAS;IAE7B,MAAM,IAAI,GAAG,gBAAgB,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,KAAK,CACR,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,iBAAiB,EAC9E,6EAA6E,CAC9E,CAAC;IACF,IAAI,CAAC,KAAK,CACR,GAAG,IAAI,qBAAqB,EAC5B,6EAA6E,CAC9E,CAAC;IACF,IAAI,CAAC,KAAK,CACR,GAAG,IAAI,sBAAsB,EAC7B,6EAA6E,CAC9E,CAAC;IACF,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mCAAiB,CAAC,EAAE;QAC3D,IAAI,CAAC,KAAK,CACR,mCAAiB,EACjB,mFAAmF;YACjF,2EAA2E;YAC3E,6EAA6E,CAChF,CAAC;KACH;AACH,CAAC;AA1BD,0DA0BC;AAWD,sEAAsE;AACtE,SAAgB,uBAAuB,CACrC,IAAU,EACV,WAAmB,EACnB,OAA+B,EAAE;IAEjC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,WAAW,EAAE,MAAM,CAAC;IACzD,MAAM,KAAK,GAA2B;QACpC,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE;QACpE,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE;QACpE,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,qBAAqB,EAAE;KACnE,CAAC;IACF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAClD,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,OAAO,CAAC;QACnC,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,SAAS;QACrD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KACpB;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAnBD,0DAmBC"}

package/dist/src/lib/utils/filesystem.d.ts

@@ -0,0 +1,7 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Writes newContent to filePath. If a file already exists and content differs,
+ * backs up the original to filePath.bak before overwriting.
+ * Returns true if the file was written, false if content was identical.
+ */
+export declare function backupAndOverwrite(tree: Tree, filePath: string, newContent: string): boolean;

package/dist/src/lib/utils/filesystem.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backupAndOverwrite = void 0;
+/**
+ * Writes newContent to filePath. If a file already exists and content differs,
+ * backs up the original to filePath.bak before overwriting.
+ * Returns true if the file was written, false if content was identical.
+ */
+function backupAndOverwrite(tree, filePath, newContent) {
+    if (tree.exists(filePath)) {
+        const existing = (tree.read(filePath) ?? Buffer.alloc(0)).toString();
+        if (existing === newContent)
+            return false;
+        tree.write(`${filePath}.bak`, existing);
+    }
+    tree.write(filePath, newContent);
+    return true;
+}
+exports.backupAndOverwrite = backupAndOverwrite;
+//# sourceMappingURL=filesystem.js.map

package/dist/src/lib/utils/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../../src/lib/utils/filesystem.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,IAAU,EAAE,QAAgB,EAAE,UAAkB;IACjF,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QACzB,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACrE,IAAI,QAAQ,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,MAAM,EAAE,QAAQ,CAAC,CAAC;KACzC;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AARD,gDAQC"}

package/dist/src/lib/utils/flutter-web.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The web platform folder of a Flutter app (what `flutter create --platforms web` writes, minus the
+ * icons). `flutter build web` refuses to run without web/index.html. The page loads Flutter through
+ * flutter_bootstrap.js (Flutter 3.22+) with no inline script, so it works under a strict CSP, and
+ * keeps $FLUTTER_BASE_HREF so `--base-href` takes effect.
+ */
+export declare function flutterWebFiles(projectName: string): Record<string, string>;