create-expo 5.0.2 → 5.1.1

package/build/601.index.js

@@ -21,7 +21,6 @@ __webpack_require__.d(__webpack_exports__, {
 
 // EXTERNAL MODULE: ../@expo/json-file/build/JsonFile.js
 var JsonFile = __webpack_require__(3064);
-var JsonFile_default = /*#__PURE__*/__webpack_require__.n(JsonFile);
 // EXTERNAL MODULE: external "crypto"
 var external_crypto_ = __webpack_require__(6982);
 var external_crypto_default = /*#__PURE__*/__webpack_require__.n(external_crypto_);
@@ -63,7 +62,7 @@ const getStateJsonPath = () => external_path_default().join(dotExpoHomeDirectory
 
 function getSession() {
     try {
-        return JsonFile_default().read(getStateJsonPath())?.auth ?? null;
+        return JsonFile["default"].read(getStateJsonPath())?.auth ?? null;
     }
     catch (error) {
         if (error.code === 'ENOENT') {
@@ -75,6 +74,8 @@ function getSession() {
 
 // EXTERNAL MODULE: ./src/utils/env.ts
 var utils_env = __webpack_require__(4342);
+// EXTERNAL MODULE: ./src/utils/update-check.ts
+var update_check = __webpack_require__(7517);
 ;// CONCATENATED MODULE: ./src/telemetry.ts
 
 
@@ -83,11 +84,19 @@ var utils_env = __webpack_require__(4342);
 
 
 
-const packageJSON = __webpack_require__(8330);
+
+const getPackageJson = () => {
+    try {
+        return __webpack_require__(8330);
+    }
+    catch {
+        return null;
+    }
+};
 const xdlUnifiedWriteKey = '1wabJGd5IiuF9Q8SGlcI90v8WTs';
 const analyticsEndpoint = 'https://cdp.expo.dev/v1/batch';
 const version = '1.0.0';
-const library = packageJSON.name;
+const library = update_check.PACKAGE_NAME;
 const messageBatch = [];
 let analyticsIdentity = null;
 // jest does not clear global variables inbetween tests so we need this helper
@@ -144,7 +153,7 @@ function enqueue(type, message) {
         message.originalTimestamp = new Date();
     }
     if (!message.messageId) {
-        // We md5 the messaage to add more randomness. This is primarily meant
+        // We md5 the message to add more randomness. This is primarily meant
         // for use in the browser where the uuid package falls back to Math.random()
         // which is not a great source of randomness.
         // Borrowed from analytics.js (https://github.com/segment-integrations/analytics.js-integration-segmentio/blob/a20d2a2d222aeb3ab2a8c7e72280f1df2618440e/lib/index.js#L255-L256).
@@ -154,7 +163,7 @@ function enqueue(type, message) {
     }
     messageBatch.push(message);
 }
-// very barebones implemention...
+// very barebones implementation...
 // does not support multiple concurrent flushes or large numbers of messages
 async function flushAsync() {
     if (utils_env.env.EXPO_NO_TELEMETRY)
@@ -180,7 +189,7 @@ async function flushAsync() {
         await fetch(analyticsEndpoint, request);
     }
     catch {
-        // supress errors - likely due to network connectivity or endpoint health
+        // suppress errors - likely due to network connectivity or endpoint health
     }
     // clear array so we don't resend events in subsequent flushes
     messageBatch.splice(0, messageBatch.length);
@@ -197,7 +206,7 @@ function getAnalyticsContext() {
     return {
         os: { name: platform, version: external_os_default().release() },
         device: { type: platform, model: platform },
-        app: { name: library, version: packageJSON.version },
+        app: { name: library, version: getPackageJson()?.version ?? undefined },
     };
 }
 //#endregion
@@ -208,7 +217,7 @@ function uuidv4() {
         return external_crypto_default().randomUUID();
     }
     catch {
-        // supress errors due to node 13 or less not having randomUUID
+        // suppress errors due to node 13 or less not having randomUUID
         return null;
     }
 }
@@ -229,14 +238,14 @@ async function getAnalyticsIdentityAsync() {
     if (!external_fs_default().existsSync(getStateJsonPath())) {
         external_fs_default().writeFileSync(getStateJsonPath(), JSON.stringify({}));
     }
-    const savedDeviceId = await JsonFile_default().getAsync(getStateJsonPath(), 'analyticsDeviceId', null);
+    const savedDeviceId = await JsonFile["default"].getAsync(getStateJsonPath(), 'analyticsDeviceId', null);
     const deviceId = savedDeviceId ?? uuidv4();
     if (!deviceId) {
         // unable to generate an id or load one from disk
         return null;
     }
     if (!savedDeviceId) {
-        await JsonFile_default().setAsync(getStateJsonPath(), 'analyticsDeviceId', deviceId);
+        await JsonFile["default"].setAsync(getStateJsonPath(), 'analyticsDeviceId', deviceId);
     }
     const userId = getSession()?.userId ?? null;
     return userId ? { anonymousId: deviceId, userId } : { anonymousId: deviceId };

package/build/{223.index.js → 870.index.js}

@@ -1,5 +1,5 @@
-exports.id = 223;
-exports.ids = [223];
+exports.id = 870;
+exports.ids = [870];
 exports.modules = {
 
 /***/ 2671:
@@ -11691,14 +11691,6 @@ function bisearch(ucs) {
 }
 
 
-/***/ }),
-
-/***/ 392:
-/***/ ((module) => {
-
-module.exports = eval("require")("../package.json");
-
-
 /***/ }),
 
 /***/ 9337:

package/build/Examples.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The partial GitHub content type, used to filter out examples.
+ * @see https://docs.github.com/en/rest/repos/contents?apiVersion=2022-11-28
+ */
+export type GithubContent = {
+    name: string;
+    path: string;
+    type: 'file' | 'dir';
+};
+export type ExamplesMetadata = {
+    aliases: {
+        [key: string]: string | {
+            destination: string;
+            message?: string;
+        };
+    };
+    deprecated: {
+        [key: string]: {
+            outdatedExampleHref: string;
+            message?: string;
+        };
+    };
+};
+/** Fetch the metadata for the examples from https://github.com/expo/examples. This includes aliases and deprecated examples. */
+export declare function fetchMetadataAsync(): Promise<ExamplesMetadata>;
+export declare function ensureExampleExists(name: string): Promise<void>;
+/** Ask the user which example to create */
+export declare function promptExamplesAsync(): Promise<any>;
+/**
+ * Download and move the selected example from https://github.com/expo/examples.
+ *
+ * If the example ships a `.create-expo.json`, its `renamePatterns`
+ * field overrides the default rename config used by the HelloWorld
+ * find-and-replace pass. The config file is read once and deleted from disk
+ * immediately so it can never leak into the user's project.
+ */
+export declare function downloadAndExtractExampleAsync(root: string, name: string): Promise<void>;
+export declare function sanitizeScriptsAsync(root: string): Promise<void>;

package/build/Template.d.ts

@@ -0,0 +1,98 @@
+import ora from 'ora';
+import type { PackageManagerName } from './resolvePackageManager';
+export declare function isFolderNameForbidden(folderName: string): boolean;
+export declare function resolvePackageModuleId(moduleId: string): {
+    readonly type: "repository";
+    readonly uri: import("url").URL;
+} | {
+    readonly type: "file";
+    readonly uri: string;
+} | {
+    readonly type: "npm";
+    readonly uri: string;
+};
+/**
+ * Extract a template app to a given file path and clean up any properties left over from npm to
+ * prepare it for usage.
+ *
+ * If the template ships a `.create-expo.json`, its `renamePatterns`
+ * field overrides the default rename config used by the HelloWorld
+ * find-and-replace pass. The config file is read once and deleted from disk
+ * immediately so it can never leak into the user's project.
+ */
+export declare function extractAndPrepareTemplateAppAsync(projectRoot: string, { npmPackage }: {
+    npmPackage?: string | null;
+}): Promise<string>;
+/**
+ * # Background
+ *
+ * `@expo/cli` and `create-expo` extract a template from a tarball (whether from
+ * a local npm project or a GitHub repository), but these templates have a
+ * static name that needs to be updated to match whatever app name the user
+ * specified.
+ *
+ * By convention, the app name of all templates is "HelloWorld". During
+ * extraction, filepaths are transformed via `createEntryRenamer()` in
+ * `createFileTransform.ts`, but the contents of files are left untouched.
+ * Technically, the contents used to be transformed during extraction as well,
+ * but due to poor configurability, we've moved to a post-extraction approach.
+ *
+ * # The new approach: Renaming the app post-extraction
+ *
+ * In this new approach, we take a list of file patterns, otherwise known as the
+ * "rename config" to determine explicitly which files – relative to the root of
+ * the template – to perform find-and-replace on, to update the app name.
+ *
+ * ## The rename config
+ *
+ * The rename config can be passed directly as a string array to
+ * `getTemplateFilesToRenameAsync()`.
+ *
+ * The file patterns are formatted as glob expressions to be interpreted by
+ * [glob](https://github.com/isaacs/node-glob). Comments are supported with
+ * the `#` symbol, both in the plain-text file and string array formats.
+ * Whitespace is trimmed and whitespace-only lines are ignored.
+ *
+ * If no rename config has been passed directly to
+ * `getTemplateFilesToRenameAsync()`, then this default
+ * rename config will be used instead.
+ */
+export declare const defaultRenameConfig: readonly ["!**/node_modules", "app.json", "android/**/*.gradle", "android/app/BUCK", "android/app/src/**/*.java", "android/app/src/**/*.kt", "android/app/src/**/*.xml", "ios/Podfile", "ios/**/*.xcodeproj/project.pbxproj", "ios/**/*.xcodeproj/xcshareddata/xcschemes/*.xcscheme", "ios/**/*.xcworkspace/contents.xcworkspacedata", "macos/Podfile", "macos/**/*.xcodeproj/project.pbxproj", "macos/**/*.xcodeproj/xcshareddata/xcschemes/*.xcscheme", "macos/**/*.xcworkspace/contents.xcworkspacedata"];
+/**
+ * Returns a list of files within a template matched by the resolved rename
+ * config.
+ *
+ * The rename config is resolved in the order of preference:
+ * Config provided as function param > defaultRenameConfig
+ */
+export declare function getTemplateFilesToRenameAsync({ cwd, 
+/**
+ * An array of patterns following the rename config format. If omitted, then
+ * we fall back to defaultRenameConfig.
+ * @see defaultRenameConfig
+ */
+renameConfig: userConfig, }: {
+    cwd: string;
+    renameConfig?: string[];
+}): Promise<string[]>;
+export declare function renameTemplateAppNameAsync({ cwd, name, files, }: {
+    cwd: string;
+    name: string;
+    /**
+     * An array of files to transform. Usually provided by calling
+     * getTemplateFilesToRenameAsync().
+     * @see getTemplateFilesToRenameAsync
+     */
+    files: string[];
+}): Promise<void>;
+/**
+ * Sanitize a template (or example) with expected `package.json` properties and files.
+ */
+export declare function sanitizeTemplateAsync(projectRoot: string): Promise<void>;
+export declare function validateName(name?: string): string | true;
+export declare function logProjectReady({ cdPath, packageManager, }: {
+    cdPath: string;
+    packageManager: PackageManagerName;
+}): void;
+export declare function installPodsAsync(projectRoot: string): Promise<boolean>;
+export declare function logNewSection(title: string): ora.Ora;

package/build/__mocks__/fs.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__mocks__/ora.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/Examples.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/Template.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/configureWorkspaces.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/createAsync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/createExpoConfig.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/createFileTransformer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/generateAgentFiles.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/promptSdkVersion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/resolvePackageManager.test.d.ts

@@ -0,0 +1 @@
+export declare const asMock: <T extends (...args: any[]) => any>(fn: T) => jest.MockedFunction<T>;

package/build/__tests__/sanitizeTemplate.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/telemetry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/build/configureWorkspaces.d.ts

@@ -0,0 +1,9 @@
+import type { PackageManagerName } from './resolvePackageManager';
+export declare const PNPM_WORKSPACE_FILENAME = "pnpm-workspace.yaml";
+/**
+ * Normalize a monorepo template's workspace-package dependency specs to the
+ * chosen package manager's convention, and — for pnpm — write a
+ * `pnpm-workspace.yaml` listing the workspace packages so they're picked up
+ * regardless of the root `package.json` `workspaces` field.
+ */
+export declare function configureWorkspacesAsync(projectRoot: string, packageManager: PackageManagerName): Promise<void>;

package/build/createAsync.d.ts

@@ -0,0 +1,11 @@
+import type { PackageManagerName } from './resolvePackageManager';
+export type Options = {
+    install: boolean;
+    template?: string | true;
+    example?: string | true;
+    yes: boolean;
+    agentsMd: boolean;
+};
+export declare function setupDependenciesAsync(projectRoot: string, props: Pick<Options, 'install'>): Promise<void>;
+export declare function createAsync(inputPath: string, options: Options): Promise<void>;
+export declare function logNodeInstallWarning(cdPath: string, packageManager: PackageManagerName, needsPods: boolean): void;

package/build/createExpoConfig.d.ts

@@ -0,0 +1,38 @@
+export declare const CREATE_EXPO_CONFIG_NAME = ".create-expo.json";
+/**
+ * Per-template configuration for customized behavior in `create-expo`.
+ * Templates that need any of these knobs can ship a
+ * `.create-expo.json` file at the template root; it is read once at
+ * project creation time and then deleted from the user's project so it
+ * doesn't leak into their repo.
+ */
+export interface CreateExpoConfig {
+    /**
+     * Glob patterns (relative to the project root) listing extra files that
+     * should be passed through the `HelloWorld` find-and-replace pass during
+     * project creation. When present, this REPLACES the default rename config
+     * (see Template.ts `defaultRenameConfig`) — useful for monorepo templates
+     * that need to reach inside per-app paths like `apps/*\/android/**\/build.gradle`.
+     */
+    renamePatterns?: string[];
+}
+/**
+ * Read `.create-expo.json` from the project root and immediately
+ * delete the file from disk so it doesn't leak into the user's project.
+ * Returns the parsed config (or `undefined` if there's no file / it's
+ * malformed). This is the "use it once" entry point that template-extraction
+ * code paths should call — every downstream consumer takes the parsed
+ * object in memory.
+ */
+export declare function consumeMonorepoConfigAsync(projectRoot: string): Promise<CreateExpoConfig | undefined>;
+/**
+ * Reads `.create-expo.json` from the project root without touching
+ * the file. Returns `undefined` if the file is missing, unreadable, or
+ * malformed — a missing file is the common case (single-app templates) and
+ * shouldn't warn.
+ *
+ * Prefer `consumeMonorepoConfigAsync` for the create-expo flow so the
+ * template-only config doesn't leak into the user's project. This function
+ * stays exported for tests and any other read-only callers.
+ */
+export declare function loadMonorepoConfigAsync(projectRoot: string): Promise<CreateExpoConfig | undefined>;

package/build/createFileTransform.d.ts

@@ -0,0 +1,5 @@
+import { TarTypeFlag } from 'multitars';
+import picomatch from 'picomatch';
+export declare function sanitizedName(name: string): string;
+export declare function createEntryRenamer(name: string): (input: string, typeflag: TarTypeFlag) => string;
+export declare function createGlobFilter(globPattern: picomatch.Glob, options?: picomatch.PicomatchOptions): (path: string) => boolean;

package/build/error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A custom error class that is used to surface a `process.exit` event to a higher
+ * level where it can be tracked through telemetry asynchronously, before exiting.
+ */
+export declare class ExitError extends Error {
+    cause: string | Error;
+    code: number;
+    constructor(cause: string | Error, code: number);
+}

package/build/generateAgentFiles.d.ts

@@ -0,0 +1 @@
+export declare function generateAgentFiles(root: string): Promise<void>;

package/build/index.d.ts

@@ -0,0 +1 @@
+export {};