ekwo-os 0.4.1

package/dist/args.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Argument parsing, by hand.
+ *
+ * The whole surface is `--flag value`, `--flag=value` and boolean switches.
+ * A parser for that is forty lines; a dependency for it is a supply chain.
+ * This CLI is handed a service_role key and a database password, so every
+ * package it pulls in is a package that could read them. It has exactly one
+ * runtime dependency from outside this repository, the Postgres driver, and
+ * that is the point.
+ *
+ * Unknown flags are refused rather than ignored: `--fiscal-yr 2026` silently
+ * doing nothing is worse than stopping.
+ */
+export interface ParsedArgs {
+    command: string | undefined;
+    flags: Map<string, string | boolean>;
+    positional: string[];
+    /**
+     * Every flag as it was written, in order, repeats included.
+     *
+     * `flags` is a map and a map keeps the last value, which is right for
+     * everything that is answered once — a currency, a language. A flag that
+     * names one of several things is answered once per thing:
+     * `--filing-period A=month --filing-period B=quarter` is two answers and not
+     * a correction of the first. `stringFlags` reads them from here.
+     */
+    occurrences: {
+        name: string;
+        value: string | boolean;
+    }[];
+}
+export declare class UsageError extends Error {
+}
+/** Splits argv into a command, its flags and whatever is left. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** A flag's value as a string, or `undefined` when it was not given. */
+export declare function stringFlag(args: ParsedArgs, name: string): string | undefined;
+/**
+ * Every value a repeatable flag was given, in the order they were written.
+ *
+ * Empty when the flag was not given at all; a refusal when it was given with
+ * no value, which is the same mistake `stringFlag` refuses for the same
+ * reason — a flag that names something and names nothing is a typo.
+ */
+export declare function stringFlags(args: ParsedArgs, name: string): string[];
+export declare function boolFlag(args: ParsedArgs, name: string): boolean;
+export declare function numberFlag(args: ParsedArgs, name: string): number | undefined;
+/**
+ * Stops on a flag nobody defined, rather than letting a typo pass.
+ *
+ * `--json` is accepted here and not in each command's list, for the reason
+ * `--help` is: it is a property of the command line and not of a command, and
+ * a command added next year answers in JSON without anybody remembering to
+ * say so.
+ */
+export declare function rejectUnknownFlags(args: ParsedArgs, known: readonly string[]): void;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;;;;;OAQG;IACH,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,CAAC;CAC1D;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA+CpD;AAQD,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM7E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAShE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM7E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CASnF"}

package/dist/args.js

@@ -0,0 +1,134 @@
+/**
+ * Argument parsing, by hand.
+ *
+ * The whole surface is `--flag value`, `--flag=value` and boolean switches.
+ * A parser for that is forty lines; a dependency for it is a supply chain.
+ * This CLI is handed a service_role key and a database password, so every
+ * package it pulls in is a package that could read them. It has exactly one
+ * runtime dependency from outside this repository, the Postgres driver, and
+ * that is the point.
+ *
+ * Unknown flags are refused rather than ignored: `--fiscal-yr 2026` silently
+ * doing nothing is worse than stopping.
+ */
+export class UsageError extends Error {
+}
+/** Splits argv into a command, its flags and whatever is left. */
+export function parseArgs(argv) {
+    const flags = new Map();
+    const occurrences = [];
+    const positional = [];
+    let command;
+    const seen = (name, value) => {
+        flags.set(name, value);
+        occurrences.push({ name, value });
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === '--') {
+            positional.push(...argv.slice(index + 1));
+            break;
+        }
+        if (token.startsWith('--')) {
+            const body = token.slice(2);
+            const equals = body.indexOf('=');
+            if (equals !== -1) {
+                seen(body.slice(0, equals), body.slice(equals + 1));
+                continue;
+            }
+            const next = argv[index + 1];
+            if (next !== undefined && !next.startsWith('-')) {
+                seen(body, next);
+                index += 1;
+            }
+            else {
+                seen(body, true);
+            }
+            continue;
+        }
+        if (token.startsWith('-') && token.length > 1) {
+            const short = SHORT_FLAGS[token];
+            if (short === undefined)
+                throw new UsageError(`unknown option: ${token}`);
+            seen(short, true);
+            continue;
+        }
+        if (command === undefined)
+            command = token;
+        else
+            positional.push(token);
+    }
+    return { command, flags, positional, occurrences };
+}
+const SHORT_FLAGS = {
+    '-h': 'help',
+    '-v': 'version',
+    '-y': 'yes',
+};
+/** A flag's value as a string, or `undefined` when it was not given. */
+export function stringFlag(args, name) {
+    const value = args.flags.get(name);
+    if (value === undefined)
+        return undefined;
+    if (value === true)
+        throw new UsageError(`--${name} needs a value`);
+    if (value === false)
+        return undefined;
+    return value;
+}
+/**
+ * Every value a repeatable flag was given, in the order they were written.
+ *
+ * Empty when the flag was not given at all; a refusal when it was given with
+ * no value, which is the same mistake `stringFlag` refuses for the same
+ * reason — a flag that names something and names nothing is a typo.
+ */
+export function stringFlags(args, name) {
+    const found = args.occurrences.filter((flag) => flag.name === name);
+    return found.map((flag) => {
+        if (flag.value === true)
+            throw new UsageError(`--${name} needs a value`);
+        if (flag.value === false)
+            throw new UsageError(`--${name} needs a value`);
+        return flag.value;
+    });
+}
+export function boolFlag(args, name) {
+    const value = args.flags.get(name);
+    if (value === undefined)
+        return false;
+    if (typeof value === 'string') {
+        if (value === 'true' || value === 'yes')
+            return true;
+        if (value === 'false' || value === 'no')
+            return false;
+        throw new UsageError(`--${name} is a switch, not a value (got "${value}")`);
+    }
+    return value;
+}
+export function numberFlag(args, name) {
+    const raw = stringFlag(args, name);
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isInteger(value))
+        throw new UsageError(`--${name} must be a whole number`);
+    return value;
+}
+/**
+ * Stops on a flag nobody defined, rather than letting a typo pass.
+ *
+ * `--json` is accepted here and not in each command's list, for the reason
+ * `--help` is: it is a property of the command line and not of a command, and
+ * a command added next year answers in JSON without anybody remembering to
+ * say so.
+ */
+export function rejectUnknownFlags(args, known) {
+    const allowed = new Set([...known, 'help', 'version', 'json']);
+    const unknown = [...args.flags.keys()].filter((name) => !allowed.has(name));
+    if (unknown.length > 0) {
+        throw new UsageError(`unknown option(s): ${unknown.map((n) => `--${n}`).join(', ')}\n` +
+            `This command accepts: ${[...known, 'json'].map((n) => `--${n}`).join(', ')}`);
+    }
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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