@imagina-build/ias-cli 0.2.2 → 0.3.1

package/src/setup-state.mjs

@@ -0,0 +1,76 @@
+// The state of ias setup: which services the app uses and what a person acknowledged. It lives outside the repository,
+// because ias build refuses a dirty tree and onboarding is per computer (a teammate runs ias setup on theirs).
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import process from 'node:process';
+
+export const SETUP_STATE_VERSION = 1;
+
+/** The services of an application, as the panel and the management API name them. */
+export const SERVICES = Object.freeze(['updates', 'distribution', 'push']);
+
+/** The folder of the state of this computer: IAS_STATE_DIR, or the one of the platform. */
+export function stateHome(env = process.env) {
+  if (env.IAS_STATE_DIR) return resolve(env.IAS_STATE_DIR);
+  if (process.platform === 'darwin') return join(homedir(), 'Library', 'Application Support', 'ias');
+  return join(env.XDG_STATE_HOME ?? join(homedir(), '.local', 'state'), 'ias');
+}
+
+/** The file of the setup of `dir`: one per app, named after its real path. */
+export function setupStateFile(dir, env = process.env) {
+  const key = createHash('sha256').update(resolve(dir)).digest('hex').slice(0, 24);
+  return join(stateHome(env), 'setup', `${key}.json`);
+}
+
+/** The state of `dir`: { version, dir, services, acknowledged, updated_at }, or a new one. */
+export function readSetupState(dir, env = process.env) {
+  const file = setupStateFile(dir, env);
+  if (!existsSync(file)) return { version: SETUP_STATE_VERSION, dir: resolve(dir), services: undefined, acknowledged: {}, updated_at: null };
+  try {
+    const state = JSON.parse(readFileSync(file, 'utf8'));
+    if (state.version !== SETUP_STATE_VERSION) return { version: SETUP_STATE_VERSION, dir: resolve(dir), services: state.services, acknowledged: {}, updated_at: null };
+    return { version: SETUP_STATE_VERSION, dir: resolve(dir), services: state.services, acknowledged: state.acknowledged ?? {}, updated_at: state.updated_at ?? null };
+  } catch {
+    return { version: SETUP_STATE_VERSION, dir: resolve(dir), services: undefined, acknowledged: {}, updated_at: null };
+  }
+}
+
+/** Writes the state of `dir` with mode 600, in a folder with mode 700. It holds no secret. */
+export function writeSetupState(dir, { services, acknowledged }, env = process.env) {
+  const file = setupStateFile(dir, env);
+  mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
+  const state = { version: SETUP_STATE_VERSION, dir: resolve(dir), services, acknowledged, updated_at: new Date().toISOString() };
+  writeFileSync(file, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+  return state;
+}
+
+/** Forgets the state of `dir` (ias setup reset): the checklist starts from what the files and the server say. */
+export function resetSetupState(dir, env = process.env) {
+  rmSync(setupStateFile(dir, env), { force: true });
+}
+
+/** The services of `--services`: a comma-separated list of updates, distribution and push, or one of them. */
+export function parseServices(text) {
+  const names = String(text).split(',').map((name) => name.trim()).filter(Boolean);
+  const unknown = names.filter((name) => !SERVICES.includes(name));
+  if (unknown.length > 0) return { error: `unknown service ${unknown.join(', ')}` };
+  return { services: [...new Set(names)] };
+}
+
+/**
+ * The services of an app when nobody said: those its configuration and its app.json show, or updates and distribution
+ * for a new one, which is what ias is for.
+ */
+export function inferServices({ config, expo, dependencies = {} }) {
+  const services = new Set();
+  if (config?.updates || expo?.updates?.url) services.add('updates');
+  if (config?.distribution) services.add('distribution');
+  if (config?.push || dependencies['expo-notifications']) services.add('push');
+  if (services.size === 0) {
+    services.add('updates');
+    services.add('distribution');
+  }
+  return [...services];
+}