@namzu/sdk 51.1.0 → 52.1.0

package/dist/authorization/shell-paths.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The files a shell command line names, read before it runs.
+ *
+ * The file tools declare a `pathArgument`, so the kernel can see which path a
+ * call reaches. A shell command line has no such argument: `cat /etc/passwd`
+ * and `echo x > ~/.profile` carry their paths inside one string, and a
+ * boundary that only reads declared arguments let both through.
+ *
+ * This is the reference terminal's answer, ported: a table of the commands
+ * whose positional arguments are paths (its path-command table and
+ * per-command extractors, version 2.1.302), the kind of access each makes (read,
+ * write or create), and the output redirections of the line. It is a
+ * reading of the text, not a model of the shell:
+ *
+ * - a word that expands at runtime (`$VAR`, `$(...)`) has no path to read;
+ *   it is reported with `unresolved` so the caller decides what an unreadable
+ *   write target is worth (the reference asks);
+ * - a `cd` earlier in the line moves every relative path after it, which the
+ *   reading does not follow, so the caller is told one happened;
+ * - a command that is not in the table contributes nothing.
+ *
+ * Nothing here touches the file system. The caller resolves the paths
+ * against the turn's roots and decides what is outside them or protected.
+ */
+import { type ShellDialect, type ShellRedirection, type ShellWord } from './shell-lexer.js';
+/** One program invocation found in a line, wrappers unwrapped. */
+export interface ShellInvocation {
+    /** The program's base name (`/bin/rm` reads as `rm`). */
+    readonly program: string;
+    /** Its arguments, as the shell passes them. */
+    readonly args: readonly ShellWord[];
+}
+/** What the lexer found, in the shape this module and the removal check share. */
+export interface ShellReading {
+    readonly invocations: readonly ShellInvocation[];
+    readonly redirections: readonly ShellRedirection[];
+    /** False when the line does not parse to the end. */
+    readonly complete: boolean;
+}
+/** Every program a line runs, and every redirection it carries. */
+export declare function readShellLine(line: string, dialect: ShellDialect): ShellReading;
+/** The kind of access a command makes to a path argument. */
+export type PathAccess = 'read' | 'write';
+/** A path a line names, as written. */
+export interface ShellPathUse {
+    /** The path with quotes removed; `~` and `$HOME` are left for the caller. */
+    readonly path: string;
+    readonly access: PathAccess;
+    /** Which program or redirection named it. */
+    readonly via: string;
+    /** True when the word is decided at runtime and `path` is not what it will be. */
+    readonly unresolved: boolean;
+}
+export interface ShellPathAccess {
+    readonly uses: readonly ShellPathUse[];
+    /** A `cd`, `pushd`, `popd` or `chdir` runs somewhere in the line. */
+    readonly changesDirectory: boolean;
+}
+/** Whether a word's value still holds an expansion the shell will perform. */
+export declare function expandsAtRuntime(word: ShellWord): boolean;
+/**
+ * The paths `reading` names: positional arguments of the commands in the
+ * table, and the targets of its redirections.
+ */
+export declare function shellPathAccess(reading: ShellReading): ShellPathAccess;
+//# sourceMappingURL=shell-paths.d.ts.map

package/dist/authorization/shell-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-paths.d.ts","sourceRoot":"","sources":["../../src/authorization/shell-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAGd,MAAM,kBAAkB,CAAA;AAEzB,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;CACnC;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAA;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAClD,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC1B;AAaD,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CA4B/E;AAED,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAA;AAEzC,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAA;IACtC,qEAAqE;IACrE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CAClC;AAmBD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEzD;AA0tBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CA4DtE"}