@gadgetinc/ggt 0.1.16 → 0.1.18

package/README.md

@@ -129,7 +129,7 @@ EXAMPLES
   Goodbye!
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/gadget-inc/ggt/blob/v0.1.16/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/gadget-inc/ggt/blob/v0.1.18/src/commands/sync.ts)_
 
 ### `ggt help [COMMAND]`
 
@@ -143,7 +143,7 @@ ARGUMENTS
   COMMAND  The command to show help for.
 ```
 
-_See code: [src/commands/help.ts](https://github.com/gadget-inc/ggt/blob/v0.1.16/src/commands/help.ts)_
+_See code: [src/commands/help.ts](https://github.com/gadget-inc/ggt/blob/v0.1.18/src/commands/help.ts)_
 
 ### `ggt list`
 
@@ -170,7 +170,7 @@ EXAMPLES
   $ ggt list --sort=slug
 ```
 
-_See code: [src/commands/list.ts](https://github.com/gadget-inc/ggt/blob/v0.1.16/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/gadget-inc/ggt/blob/v0.1.18/src/commands/list.ts)_
 
 ### `ggt login`
 
@@ -189,7 +189,7 @@ EXAMPLES
   Hello, Jane Doe (jane@example.com)
 ```
 
-_See code: [src/commands/login.ts](https://github.com/gadget-inc/ggt/blob/v0.1.16/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/gadget-inc/ggt/blob/v0.1.18/src/commands/login.ts)_
 
 ### `ggt logout`
 
@@ -204,7 +204,7 @@ EXAMPLES
   Goodbye
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/gadget-inc/ggt/blob/v0.1.16/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/gadget-inc/ggt/blob/v0.1.18/src/commands/logout.ts)_
 
 ### `ggt whoami`
 
@@ -219,7 +219,7 @@ EXAMPLES
   You are logged in as Jane Doe (jane@example.com)
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/gadget-inc/ggt/blob/v0.1.16/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/gadget-inc/ggt/blob/v0.1.18/src/commands/whoami.ts)_
 
 <!-- commandsstop -->
 

package/lib/commands/help.d.ts

@@ -1,10 +1,10 @@
-import { Command } from "@oclif/core";
+import { BaseCommand } from "../utils/base-command";
 /**
  * Copied from @oclif/plugin-help. Uses our own {@link Help} template class instead of the one from @oclif/core.
  *
  * @see https://github.com/oclif/plugin-help/blob/67b580570257b45e92d3a04d50bf2a432c59afe3/src/commands/help.ts
  */
-export default class HelpCommand extends Command {
+export default class HelpCommand extends BaseCommand<typeof HelpCommand> {
     static strict: boolean;
     static summary: string;
     static args: {

package/lib/commands/help.js

@@ -3,12 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const core_1 = require("@oclif/core");
 const help_1 = tslib_1.__importDefault(require("../utils/help"));
+const base_command_1 = require("../utils/base-command");
 /**
  * Copied from @oclif/plugin-help. Uses our own {@link Help} template class instead of the one from @oclif/core.
  *
  * @see https://github.com/oclif/plugin-help/blob/67b580570257b45e92d3a04d50bf2a432c59afe3/src/commands/help.ts
  */
-class HelpCommand extends core_1.Command {
+class HelpCommand extends base_command_1.BaseCommand {
     async run() {
         const { argv } = await this.parse();
         const help = new help_1.default(this.config, { all: true });

package/lib/commands/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"/","sources":["commands/help.ts"],"names":[],"mappings":";;;AAAA,sCAA4C;AAC5C,iEAAiC;AAEjC;;;;GAIG;AACH,MAAqB,WAAY,SAAQ,cAAO;IAY9C,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC;IACxC,CAAC;;AAfe;;;;WAAS,KAAK;GAAC;AAEf;;;;WAAU,uBAAuB;GAAC;AAElC;;;;WAAO;QACrB,OAAO,EAAE,WAAI,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,+BAA+B;SAC7C,CAAC;KACH;GAAC;kBAViB,WAAW","sourcesContent":["import { Args, Command } from \"@oclif/core\";\nimport Help from \"../utils/help\";\n\n/**\n * Copied from @oclif/plugin-help. Uses our own {@link Help} template class instead of the one from @oclif/core.\n *\n * @see https://github.com/oclif/plugin-help/blob/67b580570257b45e92d3a04d50bf2a432c59afe3/src/commands/help.ts\n */\nexport default class HelpCommand extends Command {\n  static override strict = false;\n\n  static override summary = \"Display help for ggt.\";\n\n  static override args = {\n    command: Args.string({\n      required: false,\n      description: \"The command to show help for.\",\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { argv } = await this.parse();\n    const help = new Help(this.config, { all: true });\n    await help.showHelp(argv as string[]);\n  }\n}\n"]}
+{"version":3,"file":"help.js","sourceRoot":"/","sources":["commands/help.ts"],"names":[],"mappings":";;;AAAA,sCAAmC;AACnC,iEAAiC;AACjC,wDAAoD;AAEpD;;;;GAIG;AACH,MAAqB,WAAY,SAAQ,0BAA+B;IAYtE,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC;IACxC,CAAC;;AAfe;;;;WAAS,KAAK;GAAC;AAEf;;;;WAAU,uBAAuB;GAAC;AAElC;;;;WAAO;QACrB,OAAO,EAAE,WAAI,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,+BAA+B;SAC7C,CAAC;KACH;GAAC;kBAViB,WAAW","sourcesContent":["import { Args } from \"@oclif/core\";\nimport Help from \"../utils/help\";\nimport { BaseCommand } from \"../utils/base-command\";\n\n/**\n * Copied from @oclif/plugin-help. Uses our own {@link Help} template class instead of the one from @oclif/core.\n *\n * @see https://github.com/oclif/plugin-help/blob/67b580570257b45e92d3a04d50bf2a432c59afe3/src/commands/help.ts\n */\nexport default class HelpCommand extends BaseCommand<typeof HelpCommand> {\n  static override strict = false;\n\n  static override summary = \"Display help for ggt.\";\n\n  static override args = {\n    command: Args.string({\n      required: false,\n      description: \"The command to show help for.\",\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { argv } = await this.parse();\n    const help = new Help(this.config, { all: true });\n    await help.showHelp(argv as string[]);\n  }\n}\n"]}

package/lib/commands/list.d.ts

@@ -13,5 +13,6 @@ export default class List extends BaseCommand<typeof List> {
         'no-truncate': import("@oclif/core/lib/interfaces").Flag<boolean>;
         'no-header': import("@oclif/core/lib/interfaces").Flag<boolean>;
     };
+    requireUser: boolean;
     run(): Promise<void>;
 }

package/lib/commands/list.js

@@ -7,15 +7,24 @@ const ts_dedent_1 = tslib_1.__importDefault(require("ts-dedent"));
 const base_command_1 = require("../utils/base-command");
 const context_1 = require("../utils/context");
 class List extends base_command_1.BaseCommand {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "requireUser", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+    }
     async run() {
         const { flags } = await this.parse(List);
-        const user = await context_1.context.getUser();
-        if (!user) {
-            this.error("You are not logged in -- no apps available", { exit: 1 });
-        }
         const apps = await context_1.context.getAvailableApps();
-        if (apps.length === 0 && !flags.csv) {
-            this.log("No apps found");
+        if (!apps.length) {
+            this.log((0, ts_dedent_1.default) `
+          It doesn't look like you have any applications.
+
+          Visit https://gadget.new to create one!
+      `);
             return;
         }
         core_1.ux.table(apps, {

package/lib/commands/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"/","sources":["commands/list.ts"],"names":[],"mappings":";;;AAAA,0DAA0B;AAC1B,sCAAiC;AACjC,kEAA+B;AAC/B,wDAAoD;AAEpD,8CAA2C;AAE3C,MAAqB,IAAK,SAAQ,0BAAwB;IAiBxD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,iBAAO,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE;YACT,IAAI,CAAC,KAAK,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;SACvE;QACD,MAAM,IAAI,GAAG,MAAM,iBAAO,CAAC,gBAAgB,EAAE,CAAC;QAE9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC1B,OAAO;SACR;QAED,SAAE,CAAC,KAAK,CACN,IAAkD,EAClD;YACE,EAAE,EAAE;gBACF,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,IAAI;aACf;YACD,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM;aACf;YACD,aAAa,EAAE;gBACb,MAAM,EAAE,QAAQ;aACjB;SACF,EACD;YACE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,GAAG,KAAK,EAAE,eAAe;SAC1B,CACF,CAAC;IACJ,CAAC;;AAhDe;;;;WAAU,0DAA0D;GAAC;AAErE;;;;WAAQ,MAAM;GAAC;AAEf;;;;WAAW;QACzB,IAAA,mBAAM,EAAC,IAAA,eAAK,EAAA;;;;KAIX,CAAC;KACH;GAAC;AAEc;;;;WAAQ;QACtB,GAAG,SAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KACpB;GAAC;kBAfiB,IAAI","sourcesContent":["import chalk from \"chalk\";\nimport { ux } from \"@oclif/core\";\nimport dedent from \"ts-dedent\";\nimport { BaseCommand } from \"../utils/base-command\";\nimport type { App } from \"../utils/context\";\nimport { context } from \"../utils/context\";\n\nexport default class List extends BaseCommand<typeof List> {\n  static override summary = \"List the apps available to the currently logged in user.\";\n\n  static override usage = \"list\";\n\n  static override examples = [\n    dedent(chalk`\n      {gray $ ggt list}\n      {gray $ ggt list --extended}\n      {gray $ ggt list --sort=slug}\n    `),\n  ];\n\n  static override flags = {\n    ...ux.table.flags(),\n  };\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(List);\n    const user = await context.getUser();\n    if (!user) {\n      this.error(\"You are not logged in -- no apps available\", { exit: 1 });\n    }\n    const apps = await context.getAvailableApps();\n\n    if (apps.length === 0 && !flags.csv) {\n      this.log(\"No apps found\");\n      return;\n    }\n\n    ux.table<App & Record<string, never>>(\n      apps as unknown as (App & Record<string, never>)[],\n      {\n        id: {\n          header: \"ID\",\n          extended: true,\n        },\n        slug: {\n          header: \"Slug\",\n        },\n        primaryDomain: {\n          header: \"Domain\",\n        },\n      },\n      {\n        printLine: this.log.bind(this),\n        ...flags, // parsed flags\n      }\n    );\n  }\n}\n"]}
+{"version":3,"file":"list.js","sourceRoot":"/","sources":["commands/list.ts"],"names":[],"mappings":";;;AAAA,0DAA0B;AAC1B,sCAAiC;AACjC,kEAA+B;AAC/B,wDAAoD;AAEpD,8CAA2C;AAE3C,MAAqB,IAAK,SAAQ,0BAAwB;IAA1D;;QAiBW;;;;mBAAc,IAAI;WAAC;IAmC9B,CAAC;IAjCC,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,IAAI,GAAG,MAAM,iBAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,IAAA,mBAAM,EAAA;;;;OAId,CAAC,CAAC;YACH,OAAO;SACR;QAED,SAAE,CAAC,KAAK,CACN,IAAkD,EAClD;YACE,EAAE,EAAE;gBACF,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,IAAI;aACf;YACD,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM;aACf;YACD,aAAa,EAAE;gBACb,MAAM,EAAE,QAAQ;aACjB;SACF,EACD;YACE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,GAAG,KAAK,EAAE,eAAe;SAC1B,CACF,CAAC;IACJ,CAAC;;AAlDe;;;;WAAU,0DAA0D;EAA7D,CAA8D;AAErE;;;;WAAQ,MAAM;EAAT,CAAU;AAEf;;;;WAAW;QACzB,IAAA,mBAAM,EAAC,IAAA,eAAK,EAAA;;;;KAIX,CAAC;KACH;EANuB,CAMtB;AAEc;;;;WAAQ;QACtB,GAAG,SAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KACpB;EAFoB,CAEnB;kBAfiB,IAAI","sourcesContent":["import chalk from \"chalk\";\nimport { ux } from \"@oclif/core\";\nimport dedent from \"ts-dedent\";\nimport { BaseCommand } from \"../utils/base-command\";\nimport type { App } from \"../utils/context\";\nimport { context } from \"../utils/context\";\n\nexport default class List extends BaseCommand<typeof List> {\n  static override summary = \"List the apps available to the currently logged in user.\";\n\n  static override usage = \"list\";\n\n  static override examples = [\n    dedent(chalk`\n      {gray $ ggt list}\n      {gray $ ggt list --extended}\n      {gray $ ggt list --sort=slug}\n    `),\n  ];\n\n  static override flags = {\n    ...ux.table.flags(),\n  };\n\n  override requireUser = true;\n\n  async run(): Promise<void> {\n    const { flags } = await this.parse(List);\n\n    const apps = await context.getAvailableApps();\n    if (!apps.length) {\n      this.log(dedent`\n          It doesn't look like you have any applications.\n\n          Visit https://gadget.new to create one!\n      `);\n      return;\n    }\n\n    ux.table<App & Record<string, never>>(\n      apps as unknown as (App & Record<string, never>)[],\n      {\n        id: {\n          header: \"ID\",\n          extended: true,\n        },\n        slug: {\n          header: \"Slug\",\n        },\n        primaryDomain: {\n          header: \"Domain\",\n        },\n      },\n      {\n        printLine: this.log.bind(this),\n        ...flags, // parsed flags\n      }\n    );\n  }\n}\n"]}

package/lib/commands/sync.d.ts

@@ -4,7 +4,7 @@ import PQueue from "p-queue";
 import { BaseCommand } from "../utils/base-command";
 import type { Query } from "../utils/client";
 import { Client } from "../utils/client";
-import { Ignorer } from "../utils/fs-utils";
+import { FSIgnorer } from "../utils/fs-utils";
 import type { PublishFileSyncEventsMutation, PublishFileSyncEventsMutationVariables, RemoteFilesVersionQuery, RemoteFilesVersionQueryVariables, RemoteFileSyncEventsSubscription, RemoteFileSyncEventsSubscriptionVariables } from "../__generated__/graphql";
 export default class Sync extends BaseCommand<typeof Sync> {
     static priority: number;
@@ -23,30 +23,112 @@ export default class Sync extends BaseCommand<typeof Sync> {
     };
     static examples: string[];
     requireUser: boolean;
+    /**
+     * The current status of the sync process.
+     */
     status: SyncStatus;
+    /**
+     * The absolute path to the directory to sync files to.
+     */
     dir: string;
-    recentWrites: Set<unknown>;
+    /**
+     * A list of filepaths that have changed because of a remote file-sync event. This is used to avoid sending files that
+     * we recently received from a remote file-sync event.
+     */
+    recentRemoteChanges: Set<string>;
+    /**
+     * A FIFO async callback queue that ensures we process file-sync events in the order they occurred.
+     */
     queue: PQueue<import("p-queue/dist/priority-queue").default, import("p-queue").DefaultAddOptions>;
+    /**
+     * A GraphQL client connected to the app's /edit/api/graphql-ws endpoint
+     */
     client: Client;
-    ignorer: Ignorer;
+    /**
+     * Loads the .ignore file and provides methods for checking if a file should be ignored.
+     */
+    ignorer: FSIgnorer;
+    /**
+     * Watches the local filesystem for changes.
+     */
     watcher: FSWatcher;
+    /**
+     * Holds information about the state of the local filesystem. It's persisted to `.gadget/sync.json`.
+     */
     metadata: {
+        /**
+         * The app this filesystem is synced to.
+         */
         app: string;
+        /**
+         * The last filesVersion that was successfully written to the filesystem. This is used to determine if the remote
+         * filesystem is ahead of the local one.
+         */
         filesVersion: string;
+        /**
+         * The largest mtime that was seen on the local filesystem before `ggt sync` stopped. This is used to determine if
+         * the local filesystem has changed since the last sync.
+         *
+         * Note: This does not include the mtime of files that are ignored.
+         */
         mtime: number;
     };
+    /**
+     * A debounced function that enqueue's local file changes to be sent to Gadget.
+     */
     publish: DebouncedFunc<() => void>;
+    /**
+     * Gracefully stops the sync.
+     */
     stop: (error?: unknown) => Promise<void>;
-    finished: Promise<void>;
-    markFinished: () => void;
+    /**
+     * Turns an absolute filepath into a relative one from {@linkcode dir}.
+     */
     relative(to: string): string;
+    /**
+     * Combines path segments into an absolute filepath that starts at {@linkcode dir}.
+     */
     absolute(...pathSegments: string[]): string;
-    normalize(filepath: string, isDirectory?: boolean): string;
+    /**
+     * Similar to {@linkcode relative} in that it turns a filepath into a relative one from {@linkcode dir}. However, it
+     * also changes any slashes to be posix/unix-like forward slashes, condenses repeated slashes into a single slash, and
+     * adds a trailing slash if the filepath is a directory.
+     *
+     * This is used when sending file-sync events to Gadget to ensure that the paths are consistent across platforms.
+     *
+     * @see https://www.npmjs.com/package/normalize-path
+     */
+    normalize(filepath: string, isDirectory: boolean): string;
+    /**
+     * Pretty-prints changed and deleted filepaths to the console.
+     *
+     * @param prefix The prefix to print before each line.
+     * @param changed The normalized paths that have changed.
+     * @param deleted The normalized paths that have been deleted.
+     * @param options.limit The maximum number of lines to print. Defaults to 10. If debug is enabled, this is ignored.
+     */
     logPaths(prefix: string, changed: string[], deleted: string[], { limit }?: {
         limit?: number | undefined;
     }): void;
+    /**
+     * Initializes the sync process.
+     * - Ensures the directory exists.
+     * - Ensures the directory is empty or contains a `.gadget/sync.json` file.
+     * - Ensures an app is selected and that it matches the app the directory was previously synced to.
+     * - Ensures yarn v1 is installed.
+     * - Prompts the user how to resolve conflicts if the local filesystem has changed since the last sync.
+     */
     init(): Promise<void>;
+    /**
+     * Runs the sync process until it is stopped or an error occurs.
+     */
     run(): Promise<void>;
+    /**
+     * Enqueues a function that handles file-sync events onto the {@linkcode queue}.
+     *
+     * @param fn The function to enqueue.
+     */
+    private _enqueue;
 }
 export declare enum SyncStatus {
     STARTING = 0,