@_linked/cli 1.13.0 → 1.15.0

package/defaults/app-react-native/services/api/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "experimentalDecorators": true,
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["node"]
+  },
+  "include": ["src", "linked.backend.storage.ts"]
+}

package/lib/esm/cli-methods.d.ts

@@ -24,7 +24,7 @@ export declare const createApp: (name: any, basePath?: string, options?: {
 }) => Promise<void>;
 /**
  * iOS bundle identifier from the app domain and prefix:
- * ('formaestudios.com', 'formae') -> 'com.formaestudios.formae'.
+ * ('example.com', 'demo') -> 'com.example.demo'.
  */
 export declare function reactNativeBundleId(appDomain: string, appPrefix: string): string;
 /**
@@ -34,6 +34,11 @@ export declare function reactNativeBundleId(appDomain: string, appPrefix: string
 export declare const RN_PREFIX_PATTERN: RegExp;
 /** Placeholder name of the shapes package in defaults/app-react-native. */
 export declare const RN_SHAPES_TOKEN = "app-shapes";
+/**
+ * Literal tokens in defaults/app-react-native that are replaced by names
+ * derived from the app prefix: the shapes package and the Fuseki datasets.
+ */
+export declare function reactNativeTokens(appPrefix: string): Record<string, string>;
 /**
  * Scaffold the React Native monorepo from defaults/app-react-native.
  * Identity is stamped into named fields only; the global ${...} substitution
@@ -88,7 +93,7 @@ export declare const buildBackend: () => Promise<boolean>;
 export declare const upgradePackages: () => Promise<void>;
 export declare const createPackage: (name: any, uriBase?: any, basePath?: string) => Promise<void>;
 export declare const register: (registryURL: any) => Promise<void>;
-export declare const buildPackage: (target: any, target2: any, packagePath?: string, logResults?: boolean) => Promise<any>;
+export declare const buildPackage: (target: any, target2: any, packagePath?: string, logResults?: boolean) => Promise<boolean>;
 type BuildStep = {
     name: string;
     apply: () => Promise<unknown>;

package/lib/esm/cli-methods.d.ts.map

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

package/lib/esm/cli-methods.js

@@ -14,7 +14,7 @@ import { getEnvFile } from 'env-cmd/dist/get-env-vars.js';
 import fs from 'fs-extra';
 import path, { dirname } from 'path';
 import { createInterface } from 'readline';
-import { debugInfo, execp, execPromise, getFileImports, getFiles, getLastCommitTime, getPackageJSON, isImportOutsideOfPackage, isImportWithMissingExtension, isInvalidLINCDImport, needsRebuilding, } from './utils.js';
+import { debugInfo, execp, execPromise, getFileImports, getFiles, getLastCommitTime, getPackageJSON, isImportOutsideOfPackage, isInternalLinkedImport, needsRebuilding, } from './utils.js';
 import { renameShippedDotfiles } from './utils/shippedDotfiles.js';
 import { planPackageSetup } from './utils/packageSetup.js';
 import { rewriteExtensionlessImports } from './utils/esmSpecifiers.js';
@@ -40,7 +40,7 @@ let dirname__ = typeof __dirname !== 'undefined'
  * `scripts/storage-config.js` (pre-rename). The fallback chain lets older
  * app clones keep booting through the rename.
  */
-// Plan-011: extracted to ./lifecycle.ts so the Vite SSR loader doesn't
+// Extracted to ./lifecycle.ts so the Vite SSR loader doesn't
 // have to graph-walk the rest of cli-methods.ts (which contains many
 // dynamic imports Vite can't analyze). We import for internal callers
 // AND re-export so external consumers can keep importing from here.
@@ -212,7 +212,7 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
 });
 /**
  * iOS bundle identifier from the app domain and prefix:
- * ('formaestudios.com', 'formae') -> 'com.formaestudios.formae'.
+ * ('example.com', 'demo') -> 'com.example.demo'.
  */
 export function reactNativeBundleId(appDomain, appPrefix) {
     const host = appDomain
@@ -248,6 +248,17 @@ function assertReactNativeScaffoldable(targetFolder, appPrefix) {
 }
 /** Placeholder name of the shapes package in defaults/app-react-native. */
 export const RN_SHAPES_TOKEN = 'app-shapes';
+/**
+ * Literal tokens in defaults/app-react-native that are replaced by names
+ * derived from the app prefix: the shapes package and the Fuseki datasets.
+ */
+export function reactNativeTokens(appPrefix) {
+    return {
+        [RN_SHAPES_TOKEN]: `${appPrefix}-shapes`,
+        'app-dev': `${appPrefix}-dev`,
+        'app-test': `${appPrefix}-test`,
+    };
+}
 /**
  * Replace every occurrence of `token` in the text files under `folder`
  * (node_modules and files containing a NUL byte are skipped). A literal token
@@ -310,8 +321,11 @@ export function scaffoldReactNativeApp(targetFolder_1, id_1) {
         }
         // 4a. Rename the shapes package token everywhere: workspaces, .gitignore
         // negation, package names, dependency keys, Jest patterns, import specifiers,
-        // test expectations and docs. Only the literal `app-shapes` token is replaced.
-        replaceTokenInTextFiles(targetFolder, RN_SHAPES_TOKEN, shapesName);
+        // test expectations and docs. The Fuseki dataset tokens (`app-dev`,
+        // `app-test`) are replaced the same way. Only these literal tokens change.
+        for (const [token, value] of Object.entries(reactNativeTokens(appPrefix))) {
+            replaceTokenInTextFiles(targetFolder, token, value);
+        }
         // 4b. Stamp the identity fields that are not the shapes token.
         const rootPkgPath = path.join(targetFolder, 'package.json');
         if (fs.existsSync(rootPkgPath)) {
@@ -354,7 +368,7 @@ export function scaffoldReactNativeApp(targetFolder_1, id_1) {
             }
         }
         // 6. Next steps.
-        log(`Your Linked React Native app is ready at ${chalk.blueBright(targetFolder)}`, `\nNext steps:`, `  ${chalk.blueBright(`cd ${path.basename(targetFolder)}`)}`, `  ${chalk.blueBright('npm test -w apps/mobile')}`, `  ${chalk.blueBright('cd apps/mobile && npx expo run:ios')}`);
+        log(`Your Linked React Native app is ready at ${chalk.blueBright(targetFolder)}`, `\nNext steps:`, `  ${chalk.blueBright(`cd ${path.basename(targetFolder)}`)}`, `  ${chalk.blueBright('npm test')}                                        app and API unit tests`, `  ${chalk.blueBright('cp services/api/.env.example services/api/.env')}  once`, `  ${chalk.blueBright('npm run fuseki:up')}                               Fuseki on :3030 (Docker)`, `  ${chalk.blueBright('npm run api')}                                     API-only backend on :4000`, `  ${chalk.blueBright('npm run test:integration')}                        round trip against Fuseki`, `  ${chalk.blueBright('cd apps/mobile && npx expo run:ios')}`, `See README.md (and services/api/README.md if port 3030 is taken).`);
     });
 }
 // Indirection so tests can replace the scaffold step when exercising createApp.
@@ -1162,7 +1176,7 @@ export const addShapeToBarrel = function (shapeHyphenName, root = process.cwd())
     ensureBackendImportsShapes(root);
     return barrelPath;
 };
-// Exported for Shape-Builder reuse (plan-010 T1d.4): CodeShapeSyncService adds
+// Exported for Shape-Builder reuse: CodeShapeSyncService adds
 // the `import './shapes/<Shape>.js';` line to a generated app package's index.
 export const addLineToIndex = function (line, insertMatchString, root = process.cwd(), insertAtStart = false) {
     //import ontology in index
@@ -1348,7 +1362,7 @@ export const createShape = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...
     log(`Created a new shape class template in ${chalk.magenta(targetFile.replace(basePath, ''))}`);
     // Register the shape in the shapes barrel (src/shapes/index.ts) — NOT the main index —
     // and make sure the barrel is loaded on both boot paths. This is what makes the app
-    // materialize its own shapes on boot (plan-027 / plan-028 handover).
+    // materialize its own shapes on boot.
     const barrelPath = addShapeToBarrel(hyphenName);
     log(`Registered the shape in ${chalk.magenta(barrelPath.replace(basePath, ''))}`);
 });
@@ -1386,9 +1400,10 @@ export const createComponent = (name_1, ...args_1) => __awaiter(void 0, [name_1,
         log(`Added an import of this file from ${chalk.magenta(indexPath)}`);
     }
 });
-//read the source of all ts/tsx files in the src folder
-//if there is an import that imports a lincd package with /src/ in it, then warn
-//if there is an import that imports something from outside the src folder, then warn
+// Reads the source of all ts/tsx files in the src folder and fails on imports
+// that reach outside the package source root ('outside_package'), or that point
+// into another Linked package's /src/ or /lib/ ('internal_linked'). Extensionless relative
+// imports are fine: `linked build` rewrites the emitted ESM specifiers.
 export const checkImports = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (sourceFolder = getSourceFolder(), depth = 0, // Used to check if the import is outside the src folder
 invalidImports = new Map()) {
     if (!fs.existsSync(sourceFolder)) {
@@ -1399,12 +1414,8 @@ invalidImports = new Map()) {
     // Start checking each file in the source folder
     for (const file of dir) {
         const filename = path.join(sourceFolder, file);
-        // plan-011 §P7 — skip test sources. Test files (and their helpers/probes)
-        // are not part of the shipped ESM contract, so the missing-extension rule
-        // isn't load-bearing for them; enforcing it only blocks `linked build`
-        // (the real ESM-output gate stays in force for shipped source). This is
-        // what makes `linked build` green for packages whose tests use
-        // extensionless imports (e.g. @_linked/core).
+        // Skip test sources. Test files (and their helpers/probes) are not part
+        // of the shipped package, so the import rules do not apply to them.
         if (/(?:^|[\\/])(?:tests?|__tests__|test-helpers)(?:[\\/]|$)/.test(filename) ||
             /\.(?:test|spec)\.tsx?$/.test(file) ||
             /^type-probe.*\.tsx?$/.test(file)) {
@@ -1418,16 +1429,13 @@ invalidImports = new Map()) {
                 if (statSync(filename).isDirectory()) {
                     yield checkImports(filename, depth + 1, invalidImports);
                 }
-                else {
-                    // Ignore all files that aren't one of the following:
-                    // - .ts
-                    // - .tsx
-                    continue;
-                }
             }
             catch (e) {
                 console.log(e);
             }
+            // A directory has now been recursed into, and any other file is not a
+            // source file: either way there is nothing here to read imports from.
+            continue;
         }
         const allImports = yield getFileImports(filename);
         if (!invalidImports.has(filename)) {
@@ -1440,15 +1448,9 @@ invalidImports = new Map()) {
                     importPath: i,
                 });
             }
-            if (isInvalidLINCDImport(i, depth)) {
-                invalidImports.get(filename).push({
-                    type: 'lincd',
-                    importPath: i,
-                });
-            }
-            if (isImportWithMissingExtension(i)) {
+            if (isInternalLinkedImport(i)) {
                 invalidImports.get(filename).push({
-                    type: 'missing_extension',
+                    type: 'internal_linked',
                     importPath: i,
                 });
             }
@@ -1467,26 +1469,22 @@ invalidImports = new Map()) {
                 if (type === 'outside_package') {
                     message += ' which is outside the package source root';
                 }
-                if (type === 'lincd') {
-                    message +=
-                        ' which should not contain /src/ or /lib/ in the import path';
-                }
-                if (type === 'missing_extension') {
+                if (type === 'internal_linked') {
                     message +=
-                        ' which should end with a file extension. Like .js or .scss';
+                        " which reaches into another Linked package's /src/ or /lib/." +
+                            ' That breaks when its build layout changes and bypasses its' +
+                            ' exports map. Import its public subpath instead.';
                 }
                 res += chalk.red(message + '\n');
             });
         });
-        // Throw so buildStep aborts the compile pipeline — relative imports MUST
-        // have .js (or .scss) extensions for native-ESM-compatible output.
+        // Throw so buildStep aborts the compile pipeline: importing from outside
+        // the package, or into another Linked package's /src/ or /lib/, breaks the
+        // published package.
         throw res;
     }
-    else if (depth === 0 && invalidImports.size === 0) {
-        // console.info('All imports OK');
-        // process.exit(0);
-        return true;
-    }
+    // Nothing invalid: all imports OK.
+    return true;
 });
 export const depCheckStaged = () => __awaiter(void 0, void 0, void 0, function* () {
     console.log('Checking dependencies of staged files');
@@ -1632,6 +1630,13 @@ export const runMethod = (packageName, method, options) => __awaiter(void 0, voi
                 .then(() => {
                 console.log('Done');
                 process.exit();
+            })
+                // An unmatched method (ServerCallError 501) or a provider error rejects; report it instead of an
+                // unhandled rejection.
+                .catch((err) => {
+                var _a;
+                console.error((_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : err);
+                process.exit(1);
             });
         });
     }
@@ -2181,7 +2186,6 @@ export const register = function (registryURL) {
     }
 };
 export const buildPackage = (target_1, target2_1, ...args_1) => __awaiter(void 0, [target_1, target2_1, ...args_1], void 0, function* (target, target2, packagePath = process.cwd(), logResults = true) {
-    var _a;
     // Ensure packagePath is absolute and points to a directory containing package.json; if not, go up until we find one
     // First, resolve to absolute path
     let currentPath = path.isAbsolute(packagePath)
@@ -2224,6 +2228,7 @@ export const buildPackage = (target_1, target2_1, ...args_1) => __awaiter(void 0
         }).start();
     }
     let buildProcess = Promise.resolve(true);
+    let warned = false;
     let buildStep = (step) => {
         buildProcess = buildProcess.then((previousResult) => {
             if (!previousResult) {
@@ -2237,11 +2242,14 @@ export const buildPackage = (target_1, target2_1, ...args_1) => __awaiter(void 0
                 //if a build step returns a string,
                 //a warning is shown but the build is still successful with warnings
                 if (typeof stepResult === 'string') {
-                    // spinner.text = step.name + ' - ' + stepResult;
+                    warned = true;
                     if (logResults) {
                         spinner.warn(step.name + ' - ' + stepResult);
                         spinner.stop();
                     }
+                    else {
+                        console.warn(chalk.yellow(step.name + ' - ' + stepResult));
+                    }
                     //can still continue
                     return true;
                 }
@@ -2251,21 +2259,45 @@ export const buildPackage = (target_1, target2_1, ...args_1) => __awaiter(void 0
                     }
                     return previousResult && true;
                 }
-                else if (typeof stepResult === 'object' && stepResult.error) {
+                else if (
+                //a step may report a detail alongside success, e.g. how many files
+                //it changed. Not a warning: the build stays clean.
+                stepResult &&
+                    typeof stepResult === 'object' &&
+                    stepResult.info) {
+                    if (logResults) {
+                        spinner.succeed(step.name + ' - ' + stepResult.info);
+                    }
+                    return previousResult && true;
+                }
+                else if (stepResult &&
+                    typeof stepResult === 'object' &&
+                    stepResult.error) {
                     if (logResults) {
                         spinner.fail(step.name + ' - ' + stepResult.error);
                         spinner.stop();
                     }
+                    else {
+                        console.error(chalk.red(step.name + ' - ' + stepResult.error));
+                    }
                     //failed and should stop
                     return false;
                 }
+                //anything else — notably a literal false, which several steps return
+                //on failure — is a failure. Name the step, so the build does not end
+                //on a bare 'Build failed'.
+                const failure = step.name + ' failed';
+                if (logResults) {
+                    spinner.fail(failure);
+                    spinner.stop();
+                }
+                else {
+                    console.error(chalk.red(failure));
+                }
+                return false;
             });
         });
     };
-    if (((_a = pkgJson.linked) === null || _a === void 0 ? void 0 : _a.extensionlessImports) === true) {
-        const skipped = "Skipping the import check: package.json sets 'linked.extensionlessImports'";
-        logResults ? spinner.info(skipped) : console.log(skipped);
-    }
     planBuildSteps(pkgJson, packagePath).forEach(buildStep);
     let success = yield buildProcess.catch((err) => {
         let msg = typeof err === 'string' || err instanceof Error
@@ -2278,22 +2310,21 @@ export const buildPackage = (target_1, target2_1, ...args_1) => __awaiter(void 0
                 symbol: chalk.red('✖'),
                 // text: 'Build failed',
             });
+            console.log(msg);
         }
         else {
             console.error(chalk.red(packagePath.split('/').pop(), ' - Build failed:'));
             console.error(err);
-            return msg;
         }
-        console.log(msg);
+        //a failed build always resolves to false, never to a truthy message:
+        //callers decide success by the return value.
+        return false;
     });
-    //will be undefined if there was an error
-    if (typeof success !== 'undefined' && success !== false) {
+    if (success === true) {
         if (logResults) {
             spinner.stopAndPersist({
                 symbol: chalk.greenBright('✔'),
-                text: success === true
-                    ? 'Build successful'
-                    : 'Build successful with warnings',
+                text: warned ? 'Build successful with warnings' : 'Build successful',
             });
         }
     }
@@ -2305,46 +2336,31 @@ export const buildPackage = (target_1, target2_1, ...args_1) => __awaiter(void 0
             });
         }
     }
-    return success;
+    //true only when every step succeeded (warnings included); false otherwise.
+    return success === true;
 });
-// The ordered `linked build` steps for a linkedPackage. A package whose source
-// uses extensionless relative imports (`"linked": {"extensionlessImports": true}`)
-// skips the import check and gets `.js` added to its emitted ESM specifiers.
-export const planBuildSteps = (pkgJson, packagePath) => {
-    var _a;
-    const extensionlessImports = ((_a = pkgJson.linked) === null || _a === void 0 ? void 0 : _a.extensionlessImports) === true;
-    const steps = [];
-    if (!extensionlessImports) {
-        steps.push({
-            name: 'Checking imports',
-            apply: () => checkImports(packagePath + '/src'),
-        });
-    }
-    steps.push({
+// The ordered `linked build` steps for a linkedPackage. Source may use
+// extensionless relative imports: once `lib/esm` holds everything it will ship,
+// every package gets `.js` added to the relative specifiers in it (JS and
+// declarations). For a package that already writes `.js` this is a no-op.
+export const planBuildSteps = (pkgJson, packagePath) => [
+    {
+        name: 'Checking imports',
+        apply: () => checkImports(packagePath + '/src'),
+    },
+    {
         name: 'Compiling ESM',
         apply: () => __awaiter(void 0, void 0, void 0, function* () {
             return compilePackageESM(packagePath);
         }),
-    });
-    if (extensionlessImports) {
-        steps.push({
-            name: 'Rewriting ESM import specifiers',
-            apply: () => __awaiter(void 0, void 0, void 0, function* () {
-                const libEsm = path.join(packagePath, 'lib', 'esm');
-                if (fs.existsSync(libEsm)) {
-                    yield rewriteExtensionlessImports(libEsm);
-                }
-                return true;
-            }),
-        });
-    }
-    steps.push({
+    },
+    {
         name: 'Compiling CJS',
         apply: () => __awaiter(void 0, void 0, void 0, function* () {
             return compilePackageCJS(packagePath);
         }),
-    });
-    steps.push({
+    },
+    {
         name: 'Copying files to lib folder',
         apply: () => __awaiter(void 0, void 0, void 0, function* () {
             const files = yield glob(packagePath + '/src/**/*.{json,d.ts,css,scss}');
@@ -2366,8 +2382,8 @@ export const planBuildSteps = (pkgJson, packagePath) => {
                 return allResults.every((r) => r === true);
             });
         }),
-    });
-    steps.push({
+    },
+    {
         name: 'Dual package support',
         apply: () => {
             // Skip if no tsconfig files (e.g. pure-CSS packages).
@@ -2381,19 +2397,48 @@ export const planBuildSteps = (pkgJson, packagePath) => {
                 return res === '';
             });
         },
-    });
-    steps.push({
+    },
+    {
         name: 'Removing old files from lib folder',
         apply: () => __awaiter(void 0, void 0, void 0, function* () {
             return removeOldFiles(packagePath);
         }),
-    });
-    steps.push({
+    },
+    {
+        // MUST run after 'Copying files to lib folder' and after 'Removing old
+        // files from lib folder', because the rewrite resolves each specifier
+        // against the files actually present in lib/esm:
+        // - the copy step brings in the assets (`./x.scss`) and hand-written
+        //   `.d.ts` from src; before it, an asset import looks unresolvable (a
+        //   spurious "build with warnings") and a copied `.d.ts` is never rewritten;
+        // - the cleanup step deletes stale output; before it, a leftover `x.js`
+        //   makes './x' resolve to './x.js' and the cleanup then removes the file
+        //   the specifier now points at.
+        name: 'Rewriting ESM import specifiers',
+        apply: () => __awaiter(void 0, void 0, void 0, function* () {
+            // No tsconfig-esm.json means the ESM compile was skipped (e.g. pure-CSS
+            // packages), so there is nothing to rewrite and nothing to fail over.
+            if (!fs.existsSync(path.join(packagePath, 'tsconfig-esm.json'))) {
+                return true;
+            }
+            const libEsm = path.join(packagePath, 'lib', 'esm');
+            if (!fs.existsSync(libEsm)) {
+                return {
+                    error: 'lib/esm was not emitted while tsconfig-esm.json is present. Check the ESM compile.',
+                };
+            }
+            const { changed, unresolved } = yield rewriteExtensionlessImports(libEsm);
+            if (unresolved.length > 0) {
+                return `could not resolve ${unresolved.length} import(s), left unchanged: ${unresolved.join(', ')}`;
+            }
+            return changed > 0 ? { info: `rewrote ${changed} file(s)` } : true;
+        }),
+    },
+    {
         name: 'Checking dependencies',
         apply: () => depCheck(packagePath),
-    });
-    return steps;
-};
+    },
+];
 export const compilePackage = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (packagePath = process.cwd()) {
     //echo 'compiling CJS' && tsc -p tsconfig-cjs.json && echo 'compiling ESM' && tsc -p tsconfig-esm.json
     // let cjsConfig = fs.existsSync(path.join(packagePath,'tsconfig-cjs.json'));
@@ -2717,12 +2762,10 @@ export var buildUpdated = function (back_1, target_1, target2_1) {
                     // log('path: ' + pathToBuild);
                     return buildPackage(null, null, pathToBuild, false)
                         .then((res) => {
-                        //empty string or true is success
-                        //false is success with warnings
-                        //any other string is the build error text
-                        //undefined result means it failed
-                        if (typeof res === 'undefined' || typeof res === 'string') {
-                            logError('Failed to build ' + pkg.packageName + '. ' + res ? res : '');
+                        //buildPackage returns true only when the build succeeded
+                        //(warnings included); anything else is a failure.
+                        if (res !== true) {
+                            logError('Failed to build ' + pkg.packageName);
                             process.exit(1);
                         }
                         else {