@gadgetinc/dateilager 0.8.10 → 0.9.1

package/dist/esm/binary-client.d.ts

@@ -108,14 +108,16 @@ export declare class DateiLagerBinaryClient {
     constructor(options: DateiLagerBinaryClientOptions);
     /**
      * Update objects in a project based on the differences in a local directory.
-     * @param project         The id of the project.
-     * @param directory       The path of the directory to send updates from.
-     * @param options         Object of options.
-     * @param options.timeout Number of milliseconds to wait before terminating the process.
-     * @returns               The latest project version or `null` if something went wrong.
+     * @param project          The id of the project.
+     * @param directory        The path of the directory to send updates from.
+     * @param options          Object of options.
+     * @param options.timeout  Number of milliseconds to wait before terminating the process.
+     * @param options.subpaths The paths to include when updating the FS.
+     * @returns                The latest project version or `null` if something went wrong.
      */
     update(project: bigint, directory: string, options?: {
         timeout?: number;
+        subpaths?: string[];
     }): Promise<bigint | null>;
     /**
      * Rebuild the local filesystem.
@@ -125,6 +127,7 @@ export declare class DateiLagerBinaryClient {
      * @param options              Object of options.
      * @param options.timeout      Number of milliseconds to wait before terminating the process.
      * @param options.ignores      The paths to ignore when rebuilding the FS.
+     * @param options.subpaths     The paths to include when rebuilding the FS.
      * @param options.summarize    Should produce the summary file after rebuilding.
      * @param options.cacheDir     Path where the cache directory is mounted.
      * @param options.matchInclude Set fileMatch to true if the written files are matched by this glob pattern
@@ -134,6 +137,7 @@ export declare class DateiLagerBinaryClient {
     rebuild(project: bigint, to: bigint | null, directory: string, options?: {
         timeout?: number;
         ignores?: string[];
+        subpaths?: string[];
         summarize?: boolean;
         cacheDir?: string;
         matchInclude?: string;
@@ -145,6 +149,7 @@ export declare class DateiLagerBinaryClient {
      * @param from            Where to start cleanup
      * @param options         dict options passed
      * @param options.timeout timeout limit for the request
+     * @returns               The number of records garbage collected
      */
     gcRandomProjects(sample: number, keep: number, from?: number, options?: {
         timeout?: number;
@@ -156,6 +161,7 @@ export declare class DateiLagerBinaryClient {
      * @param from            Where to start cleanup
      * @param options         dict options passed
      * @param options.timeout timeout limit for the request
+     * @returns               The number of records garbage collected
      */
     gcProject(project: number, keep: number, from?: number, options?: {
         timeout?: number;
@@ -165,6 +171,7 @@ export declare class DateiLagerBinaryClient {
      * @param sample          sample size of cleanup
      * @param options         dict options passed
      * @param options.timeout timeout limit for the request
+     * @returns               The number of records garbage collected
      */
     gcContents(sample: number, options?: {
         timeout?: number;

package/dist/esm/binary-client.js

@@ -44,11 +44,12 @@ export class DateiLagerBinaryClient {
     }
     /**
      * Update objects in a project based on the differences in a local directory.
-     * @param project         The id of the project.
-     * @param directory       The path of the directory to send updates from.
-     * @param options         Object of options.
-     * @param options.timeout Number of milliseconds to wait before terminating the process.
-     * @returns               The latest project version or `null` if something went wrong.
+     * @param project          The id of the project.
+     * @param directory        The path of the directory to send updates from.
+     * @param options          Object of options.
+     * @param options.timeout  Number of milliseconds to wait before terminating the process.
+     * @param options.subpaths The paths to include when updating the FS.
+     * @returns                The latest project version or `null` if something went wrong.
      */
     async update(project, directory, options) {
         return await trace("dateilager-binary-client.update", {
@@ -58,6 +59,9 @@ export class DateiLagerBinaryClient {
             },
         }, async () => {
             const args = ["--dir", String(directory), "--project", String(project)];
+            if (options?.subpaths) {
+                args.push(`--subpaths=${options.subpaths.join(",")}`);
+            }
             const result = await this._call("update", args, directory, options);
             if (result.stdout == "-1") {
                 return null;
@@ -73,6 +77,7 @@ export class DateiLagerBinaryClient {
      * @param options              Object of options.
      * @param options.timeout      Number of milliseconds to wait before terminating the process.
      * @param options.ignores      The paths to ignore when rebuilding the FS.
+     * @param options.subpaths     The paths to include when rebuilding the FS.
      * @param options.summarize    Should produce the summary file after rebuilding.
      * @param options.cacheDir     Path where the cache directory is mounted.
      * @param options.matchInclude Set fileMatch to true if the written files are matched by this glob pattern
@@ -107,6 +112,9 @@ export class DateiLagerBinaryClient {
             if (options?.matchExclude) {
                 args.push(`--matchexclude=${options.matchExclude}`);
             }
+            if (options?.subpaths) {
+                args.push(`--subpaths=${options.subpaths.join(",")}`);
+            }
             args.push("--project", String(project), "--dir", directory);
             const result = await this._call("rebuild", args, directory, options);
             const parsed = JSON.parse(result.stdout);
@@ -119,6 +127,7 @@ export class DateiLagerBinaryClient {
      * @param from            Where to start cleanup
      * @param options         dict options passed
      * @param options.timeout timeout limit for the request
+     * @returns               The number of records garbage collected
      */
     async gcRandomProjects(sample, keep, from, options) {
         return await trace("dateilager-binary-client.gc", {
@@ -144,6 +153,7 @@ export class DateiLagerBinaryClient {
      * @param from            Where to start cleanup
      * @param options         dict options passed
      * @param options.timeout timeout limit for the request
+     * @returns               The number of records garbage collected
      */
     async gcProject(project, keep, from, options) {
         return await trace("dateilager-binary-client.gc", {
@@ -166,6 +176,7 @@ export class DateiLagerBinaryClient {
      * @param sample          sample size of cleanup
      * @param options         dict options passed
      * @param options.timeout timeout limit for the request
+     * @returns               The number of records garbage collected
      */
     async gcContents(sample, options) {
         return await trace("dateilager-binary-client.gc", {

package/dist/esm/binary-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"binary-client.js","sourceRoot":"","sources":["../../src/binary-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, propagation } from \"@opentelemetry/api\";\nimport type { ExecaReturnValue } from \"execa\";\nimport execa from \"execa\";\nimport fs from \"fs/promises\";\nimport readline from \"readline\";\nimport { trace } from \"./internal/telemetry\";\n\n/**\n * Options for {@link DateiLagerBinaryClient}.\n */\nexport interface DateiLagerBinaryClientOptions {\n  /**\n   * The address of the dateilager server.\n   */\n  server: {\n    /**\n     * The host of the dateilager server.\n     */\n    host: string;\n\n    /**\n     * The port of the dateilager server.\n     */\n    port?: number;\n\n    /**\n     * The GRPC headless service hostname, used for load balancing across multiple servers.\n     */\n    headlessHost?: string;\n  };\n\n  /**\n   * The token that will be sent as authorization metadata to the dateilager server.\n   */\n  token: string | (() => Promise<string>);\n\n  /**\n   * The path to the dateilager-client executable.\n   * @default \"dateilager-client\"\n   */\n  command?: string;\n\n  /**\n   * The default number of milliseconds to wait before terminating any command.\n   * @default 0 No timeout.\n   */\n  timeout?:\n    | number\n    | {\n        /**\n         * The default number of milliseconds to wait before terminating the update command.\n         * @default 0 No timeout.\n         */\n        update?: number;\n\n        /**\n         * The default number of milliseconds to wait before terminating the rebuild command.\n         * @default 0 No timeout.\n         */\n        rebuild?: number;\n\n        /**\n         * The default number of milliseconds to wait before terminating the gc command.\n         * @default 0 No timeout.\n         */\n        gc?: number;\n      };\n\n  /**\n   * Whether the dateilager binary client should enable tracing.\n   * @default false\n   */\n  tracing?: boolean;\n\n  /**\n   * Logging configuration.\n   */\n  logger?: {\n    /**\n     * The log level to pass to the dateilager binary client.\n     */\n    level: \"debug\" | \"info\" | \"warn\" | \"error\";\n\n    /**\n     * The function that will be called when the dateilager binary client logs something.\n     */\n    log: (level: \"debug\" | \"info\" | \"warn\" | \"error\", msg: string, fields: Record<string, unknown>) => void;\n  };\n}\n\n/**\n * The version of the filesystem after the call to rebuild.\n *\n * If a file pattern was included then patternDetected can be used to know if that filepattern was seen while rebuilding.\n */\nexport interface RebuildResult {\n  /**\n   * Filesystem version.\n   */\n  version: bigint;\n  /**\n   * Files updated by the rebuild operation.\n   */\n  count: number;\n  /**\n   * Whether or not the file match was detected.\n   */\n  fileMatch: boolean;\n}\n\n/**\n * The Result from calling the Dateilager Garbage Compiler\n */\nexport interface GCResult {\n  /**\n   * The number of records garbage collected\n   */\n  count: number;\n}\n\n/**\n * A version of the DateiLager client that uses the compiled binary client instead of the Javascript one.\n *\n * Useful for working directly with a real filesystem instead of in memory objects.\n */\nexport class DateiLagerBinaryClient {\n  /** @internal */\n  private readonly _options;\n\n  /**\n   * @param options An object with {@link DateiLagerBinaryClientOptions options}.\n   */\n  public constructor(options: DateiLagerBinaryClientOptions) {\n    this._options = {\n      host: options.server.host,\n      port: options.server.port ?? 5051,\n      headlessHost: options.server.headlessHost,\n      token: typeof options.token === \"string\" ? () => Promise.resolve(options.token as string) : options.token,\n      command: options.command ?? \"dateilager-client\",\n      timeout:\n        typeof options.timeout === \"number\"\n          ? {\n              update: options.timeout,\n              rebuild: options.timeout,\n              gc: options.timeout,\n            }\n          : {\n              update: 0,\n              rebuild: 0,\n              gc: 0,\n              ...options.timeout,\n            },\n      tracing: options.tracing ?? false,\n      logger: options.logger,\n    };\n  }\n\n  /**\n   * Update objects in a project based on the differences in a local directory.\n   * @param project         The id of the project.\n   * @param directory       The path of the directory to send updates from.\n   * @param options         Object of options.\n   * @param options.timeout Number of milliseconds to wait before terminating the process.\n   * @returns               The latest project version or `null` if something went wrong.\n   */\n  public async update(project: bigint, directory: string, options?: { timeout?: number }): Promise<bigint | null> {\n    return await trace(\n      \"dateilager-binary-client.update\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.directory\": directory,\n        },\n      },\n      async () => {\n        const args = [\"--dir\", String(directory), \"--project\", String(project)];\n        const result = await this._call(\"update\", args, directory, options);\n\n        if (result.stdout == \"-1\") {\n          return null;\n        }\n\n        return BigInt(result.stdout);\n      }\n    );\n  }\n\n  /**\n   * Rebuild the local filesystem.\n   * @param project              The id of the project.\n   * @param to                   The version of the project to rebuild the filesystem to.\n   * @param directory            The path of the directory to rebuild the filesystem at.\n   * @param options              Object of options.\n   * @param options.timeout      Number of milliseconds to wait before terminating the process.\n   * @param options.ignores      The paths to ignore when rebuilding the FS.\n   * @param options.summarize    Should produce the summary file after rebuilding.\n   * @param options.cacheDir     Path where the cache directory is mounted.\n   * @param options.matchInclude Set fileMatch to true if the written files are matched by this glob pattern\n   * @param options.matchExclude Set fileMatch to false if the written files are matched by this glob pattern\n   * @returns                    The latest project version or `null` if something went wrong.\n   */\n  public async rebuild(\n    project: bigint,\n    to: bigint | null,\n    directory: string,\n    options?: {\n      timeout?: number;\n      ignores?: string[];\n      summarize?: boolean;\n      cacheDir?: string;\n      matchInclude?: string;\n      matchExclude?: string;\n    }\n  ): Promise<RebuildResult> {\n    return await trace(\n      \"dateilager-binary-client.rebuild\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.to\": String(to),\n          \"dl.directory\": directory,\n        },\n      },\n      async () => {\n        await fs.mkdir(directory, { recursive: true });\n\n        const args = [\"--dir\", directory];\n        if (to) {\n          args.push(\"--to\", String(to));\n        }\n\n        if (options?.ignores) {\n          args.push(\"--ignores\", options.ignores.join(\",\"));\n        }\n\n        if (options?.summarize === false) {\n          args.push(\"--summarize=false\");\n        }\n\n        if (options?.cacheDir) {\n          args.push(`--cachedir=${options.cacheDir}`);\n        }\n\n        if (options?.matchInclude) {\n          args.push(`--matchinclude=${options.matchInclude}`);\n        }\n\n        if (options?.matchExclude) {\n          args.push(`--matchexclude=${options.matchExclude}`);\n        }\n\n        args.push(\"--project\", String(project), \"--dir\", directory);\n        const result = await this._call(\"rebuild\", args, directory, options);\n        const parsed = JSON.parse(result.stdout) as { version: number; count: number; fileMatch: boolean };\n        return { version: BigInt(parsed.version), count: parsed.count, fileMatch: parsed.fileMatch };\n      }\n    );\n  }\n\n  /**\n   * @param sample          sample size of cleanup\n   * @param keep            The amount of records to keep\n   * @param from            Where to start cleanup\n   * @param options         dict options passed\n   * @param options.timeout timeout limit for the request\n   */\n  public async gcRandomProjects(sample: number, keep: number, from?: number, options?: { timeout?: number }): Promise<GCResult> {\n    return await trace(\n      \"dateilager-binary-client.gc\",\n      {\n        attributes: {\n          \"db.mode\": \"random-projects\",\n          \"dl.keep\": String(keep),\n          \"dl.from\": String(from),\n          \"dl.sample\": String(sample),\n        },\n      },\n      async () => {\n        const args = [\"--mode\", \"random-projects\", \"--keep\", String(keep), \"--sample\", String(sample)];\n\n        if (from) args.push(\"--from\", String(from));\n\n        const result = await this._call(\"gc\", args, undefined, options);\n        const parsed = JSON.parse(result.stdout) as { count: number };\n        return { count: parsed.count };\n      }\n    );\n  }\n\n  /**\n   *\n   * @param project         The selected project to cleanup\n   * @param keep            The amount of records to keep\n   * @param from            Where to start cleanup\n   * @param options         dict options passed\n   * @param options.timeout timeout limit for the request\n   */\n  public async gcProject(project: number, keep: number, from?: number, options?: { timeout?: number }): Promise<GCResult> {\n    return await trace(\n      \"dateilager-binary-client.gc\",\n      {\n        attributes: {\n          \"db.mode\": \"project\",\n          \"dl.keep\": String(keep),\n          \"dl.from\": String(from),\n        },\n      },\n      async () => {\n        const args = [\"--mode\", \"project\", \"--keep\", String(keep), \"--project\", String(project)];\n\n        if (from) args.push(\"--from\", String(from));\n\n        const result = await this._call(\"gc\", args, undefined, options);\n        const parsed = JSON.parse(result.stdout) as { count: number };\n        return { count: parsed.count };\n      }\n    );\n  }\n\n  /**\n   *\n   * @param sample          sample size of cleanup\n   * @param options         dict options passed\n   * @param options.timeout timeout limit for the request\n   */\n  public async gcContents(sample: number, options?: { timeout?: number }): Promise<GCResult> {\n    return await trace(\n      \"dateilager-binary-client.gc\",\n      {\n        attributes: {\n          \"db.mode\": \"contents\",\n          \"dl.sample\": String(sample),\n        },\n      },\n      async () => {\n        const args = [\"--mode\", \"contents\", \"--sample\", String(sample)];\n\n        const result = await this._call(\"gc\", args, undefined, options);\n        const parsed = JSON.parse(result.stdout) as { count: number };\n        return { count: parsed.count };\n      }\n    );\n  }\n\n  /** @internal */\n  private async _call(\n    method: \"update\" | \"rebuild\" | \"gc\",\n    args: string[],\n    cwd?: string,\n    options?: { timeout?: number }\n  ): Promise<ExecaReturnValue> {\n    const baseArgs = [method, \"--host\", this._options.host, \"--port\", String(this._options.port), \"--log-encoding\", \"json\"];\n\n    if (this._options.logger) {\n      baseArgs.push(\"--log-level\", this._options.logger.level);\n    }\n\n    if (this._options.headlessHost) {\n      baseArgs.push(\"--headless-host\", this._options.headlessHost);\n    }\n\n    const timeout = options?.timeout ?? this._options.timeout[method];\n    baseArgs.push(\"--timeout\", String(timeout));\n\n    if (this._options.tracing) {\n      const carrier = {};\n      propagation.inject(context.active(), carrier);\n      const otelContext = JSON.stringify(carrier);\n\n      baseArgs.push(\"--tracing\", \"--otel-context\", otelContext);\n    }\n    const subprocess = execa(this._options.command, baseArgs.concat(args), {\n      cwd,\n      cleanup: false, // don't terminate this subprocess process eagerly when the parent process is terminated, which is execa's default behaviour. we use graceful shutdown gadget-side to give running operations a chance to complete, and we don't want to terminate them prematurely\n      env: { DL_TOKEN: await this._options.token() },\n    });\n\n    if (this._options.logger && subprocess.stderr) {\n      readline.createInterface(subprocess.stderr).on(\"line\", (line) => {\n        try {\n          // we purposefully extract and ignore the `ts` field\n          // eslint-disable-next-line @typescript-eslint/no-unused-vars\n          const { level, msg, ts, ...fields } = JSON.parse(line) as {\n            [key: string]: unknown;\n            level: \"debug\" | \"info\" | \"warn\" | \"error\";\n            msg: string;\n            ts: string | number;\n          };\n\n          this._options.logger?.log(level, msg, fields);\n        } catch (error) {\n          this._options.logger?.log(\"warn\", \"failed to log line\", { error, line });\n        }\n      });\n    }\n\n    return subprocess;\n  }\n}\n"]}
+{"version":3,"file":"binary-client.js","sourceRoot":"","sources":["../../src/binary-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { context, propagation } from \"@opentelemetry/api\";\nimport type { ExecaReturnValue } from \"execa\";\nimport execa from \"execa\";\nimport fs from \"fs/promises\";\nimport readline from \"readline\";\nimport { trace } from \"./internal/telemetry\";\n\n/**\n * Options for {@link DateiLagerBinaryClient}.\n */\nexport interface DateiLagerBinaryClientOptions {\n  /**\n   * The address of the dateilager server.\n   */\n  server: {\n    /**\n     * The host of the dateilager server.\n     */\n    host: string;\n\n    /**\n     * The port of the dateilager server.\n     */\n    port?: number;\n\n    /**\n     * The GRPC headless service hostname, used for load balancing across multiple servers.\n     */\n    headlessHost?: string;\n  };\n\n  /**\n   * The token that will be sent as authorization metadata to the dateilager server.\n   */\n  token: string | (() => Promise<string>);\n\n  /**\n   * The path to the dateilager-client executable.\n   * @default \"dateilager-client\"\n   */\n  command?: string;\n\n  /**\n   * The default number of milliseconds to wait before terminating any command.\n   * @default 0 No timeout.\n   */\n  timeout?:\n    | number\n    | {\n        /**\n         * The default number of milliseconds to wait before terminating the update command.\n         * @default 0 No timeout.\n         */\n        update?: number;\n\n        /**\n         * The default number of milliseconds to wait before terminating the rebuild command.\n         * @default 0 No timeout.\n         */\n        rebuild?: number;\n\n        /**\n         * The default number of milliseconds to wait before terminating the gc command.\n         * @default 0 No timeout.\n         */\n        gc?: number;\n      };\n\n  /**\n   * Whether the dateilager binary client should enable tracing.\n   * @default false\n   */\n  tracing?: boolean;\n\n  /**\n   * Logging configuration.\n   */\n  logger?: {\n    /**\n     * The log level to pass to the dateilager binary client.\n     */\n    level: \"debug\" | \"info\" | \"warn\" | \"error\";\n\n    /**\n     * The function that will be called when the dateilager binary client logs something.\n     */\n    log: (level: \"debug\" | \"info\" | \"warn\" | \"error\", msg: string, fields: Record<string, unknown>) => void;\n  };\n}\n\n/**\n * The version of the filesystem after the call to rebuild.\n *\n * If a file pattern was included then patternDetected can be used to know if that filepattern was seen while rebuilding.\n */\nexport interface RebuildResult {\n  /**\n   * Filesystem version.\n   */\n  version: bigint;\n  /**\n   * Files updated by the rebuild operation.\n   */\n  count: number;\n  /**\n   * Whether or not the file match was detected.\n   */\n  fileMatch: boolean;\n}\n\n/**\n * The Result from calling the Dateilager Garbage Compiler\n */\nexport interface GCResult {\n  /**\n   * The number of records garbage collected\n   */\n  count: number;\n}\n\n/**\n * A version of the DateiLager client that uses the compiled binary client instead of the Javascript one.\n *\n * Useful for working directly with a real filesystem instead of in memory objects.\n */\nexport class DateiLagerBinaryClient {\n  /** @internal */\n  private readonly _options;\n\n  /**\n   * @param options An object with {@link DateiLagerBinaryClientOptions options}.\n   */\n  public constructor(options: DateiLagerBinaryClientOptions) {\n    this._options = {\n      host: options.server.host,\n      port: options.server.port ?? 5051,\n      headlessHost: options.server.headlessHost,\n      token: typeof options.token === \"string\" ? () => Promise.resolve(options.token as string) : options.token,\n      command: options.command ?? \"dateilager-client\",\n      timeout:\n        typeof options.timeout === \"number\"\n          ? {\n              update: options.timeout,\n              rebuild: options.timeout,\n              gc: options.timeout,\n            }\n          : {\n              update: 0,\n              rebuild: 0,\n              gc: 0,\n              ...options.timeout,\n            },\n      tracing: options.tracing ?? false,\n      logger: options.logger,\n    };\n  }\n\n  /**\n   * Update objects in a project based on the differences in a local directory.\n   * @param project          The id of the project.\n   * @param directory        The path of the directory to send updates from.\n   * @param options          Object of options.\n   * @param options.timeout  Number of milliseconds to wait before terminating the process.\n   * @param options.subpaths The paths to include when updating the FS.\n   * @returns                The latest project version or `null` if something went wrong.\n   */\n  public async update(project: bigint, directory: string, options?: { timeout?: number; subpaths?: string[] }): Promise<bigint | null> {\n    return await trace(\n      \"dateilager-binary-client.update\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.directory\": directory,\n        },\n      },\n      async () => {\n        const args = [\"--dir\", String(directory), \"--project\", String(project)];\n        if (options?.subpaths) {\n          args.push(`--subpaths=${options.subpaths.join(\",\")}`);\n        }\n        const result = await this._call(\"update\", args, directory, options);\n\n        if (result.stdout == \"-1\") {\n          return null;\n        }\n\n        return BigInt(result.stdout);\n      }\n    );\n  }\n\n  /**\n   * Rebuild the local filesystem.\n   * @param project              The id of the project.\n   * @param to                   The version of the project to rebuild the filesystem to.\n   * @param directory            The path of the directory to rebuild the filesystem at.\n   * @param options              Object of options.\n   * @param options.timeout      Number of milliseconds to wait before terminating the process.\n   * @param options.ignores      The paths to ignore when rebuilding the FS.\n   * @param options.subpaths     The paths to include when rebuilding the FS.\n   * @param options.summarize    Should produce the summary file after rebuilding.\n   * @param options.cacheDir     Path where the cache directory is mounted.\n   * @param options.matchInclude Set fileMatch to true if the written files are matched by this glob pattern\n   * @param options.matchExclude Set fileMatch to false if the written files are matched by this glob pattern\n   * @returns                    The latest project version or `null` if something went wrong.\n   */\n  public async rebuild(\n    project: bigint,\n    to: bigint | null,\n    directory: string,\n    options?: {\n      timeout?: number;\n      ignores?: string[];\n      subpaths?: string[];\n      summarize?: boolean;\n      cacheDir?: string;\n      matchInclude?: string;\n      matchExclude?: string;\n    }\n  ): Promise<RebuildResult> {\n    return await trace(\n      \"dateilager-binary-client.rebuild\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.to\": String(to),\n          \"dl.directory\": directory,\n        },\n      },\n      async () => {\n        await fs.mkdir(directory, { recursive: true });\n\n        const args = [\"--dir\", directory];\n        if (to) {\n          args.push(\"--to\", String(to));\n        }\n\n        if (options?.ignores) {\n          args.push(\"--ignores\", options.ignores.join(\",\"));\n        }\n\n        if (options?.summarize === false) {\n          args.push(\"--summarize=false\");\n        }\n\n        if (options?.cacheDir) {\n          args.push(`--cachedir=${options.cacheDir}`);\n        }\n\n        if (options?.matchInclude) {\n          args.push(`--matchinclude=${options.matchInclude}`);\n        }\n\n        if (options?.matchExclude) {\n          args.push(`--matchexclude=${options.matchExclude}`);\n        }\n\n        if (options?.subpaths) {\n          args.push(`--subpaths=${options.subpaths.join(\",\")}`);\n        }\n\n        args.push(\"--project\", String(project), \"--dir\", directory);\n        const result = await this._call(\"rebuild\", args, directory, options);\n        const parsed = JSON.parse(result.stdout) as { version: number; count: number; fileMatch: boolean };\n        return { version: BigInt(parsed.version), count: parsed.count, fileMatch: parsed.fileMatch };\n      }\n    );\n  }\n\n  /**\n   * @param sample          sample size of cleanup\n   * @param keep            The amount of records to keep\n   * @param from            Where to start cleanup\n   * @param options         dict options passed\n   * @param options.timeout timeout limit for the request\n   * @returns               The number of records garbage collected\n   */\n  public async gcRandomProjects(sample: number, keep: number, from?: number, options?: { timeout?: number }): Promise<GCResult> {\n    return await trace(\n      \"dateilager-binary-client.gc\",\n      {\n        attributes: {\n          \"db.mode\": \"random-projects\",\n          \"dl.keep\": String(keep),\n          \"dl.from\": String(from),\n          \"dl.sample\": String(sample),\n        },\n      },\n      async () => {\n        const args = [\"--mode\", \"random-projects\", \"--keep\", String(keep), \"--sample\", String(sample)];\n\n        if (from) args.push(\"--from\", String(from));\n\n        const result = await this._call(\"gc\", args, undefined, options);\n        const parsed = JSON.parse(result.stdout) as { count: number };\n        return { count: parsed.count };\n      }\n    );\n  }\n\n  /**\n   *\n   * @param project         The selected project to cleanup\n   * @param keep            The amount of records to keep\n   * @param from            Where to start cleanup\n   * @param options         dict options passed\n   * @param options.timeout timeout limit for the request\n   * @returns               The number of records garbage collected\n   */\n  public async gcProject(project: number, keep: number, from?: number, options?: { timeout?: number }): Promise<GCResult> {\n    return await trace(\n      \"dateilager-binary-client.gc\",\n      {\n        attributes: {\n          \"db.mode\": \"project\",\n          \"dl.keep\": String(keep),\n          \"dl.from\": String(from),\n        },\n      },\n      async () => {\n        const args = [\"--mode\", \"project\", \"--keep\", String(keep), \"--project\", String(project)];\n\n        if (from) args.push(\"--from\", String(from));\n\n        const result = await this._call(\"gc\", args, undefined, options);\n        const parsed = JSON.parse(result.stdout) as { count: number };\n        return { count: parsed.count };\n      }\n    );\n  }\n\n  /**\n   *\n   * @param sample          sample size of cleanup\n   * @param options         dict options passed\n   * @param options.timeout timeout limit for the request\n   * @returns               The number of records garbage collected\n   */\n  public async gcContents(sample: number, options?: { timeout?: number }): Promise<GCResult> {\n    return await trace(\n      \"dateilager-binary-client.gc\",\n      {\n        attributes: {\n          \"db.mode\": \"contents\",\n          \"dl.sample\": String(sample),\n        },\n      },\n      async () => {\n        const args = [\"--mode\", \"contents\", \"--sample\", String(sample)];\n\n        const result = await this._call(\"gc\", args, undefined, options);\n        const parsed = JSON.parse(result.stdout) as { count: number };\n        return { count: parsed.count };\n      }\n    );\n  }\n\n  /** @internal */\n  private async _call(\n    method: \"update\" | \"rebuild\" | \"gc\",\n    args: string[],\n    cwd?: string,\n    options?: { timeout?: number }\n  ): Promise<ExecaReturnValue> {\n    const baseArgs = [method, \"--host\", this._options.host, \"--port\", String(this._options.port), \"--log-encoding\", \"json\"];\n\n    if (this._options.logger) {\n      baseArgs.push(\"--log-level\", this._options.logger.level);\n    }\n\n    if (this._options.headlessHost) {\n      baseArgs.push(\"--headless-host\", this._options.headlessHost);\n    }\n\n    const timeout = options?.timeout ?? this._options.timeout[method];\n    baseArgs.push(\"--timeout\", String(timeout));\n\n    if (this._options.tracing) {\n      const carrier = {};\n      propagation.inject(context.active(), carrier);\n      const otelContext = JSON.stringify(carrier);\n\n      baseArgs.push(\"--tracing\", \"--otel-context\", otelContext);\n    }\n    const subprocess = execa(this._options.command, baseArgs.concat(args), {\n      cwd,\n      cleanup: false, // don't terminate this subprocess process eagerly when the parent process is terminated, which is execa's default behaviour. we use graceful shutdown gadget-side to give running operations a chance to complete, and we don't want to terminate them prematurely\n      env: { DL_TOKEN: await this._options.token() },\n    });\n\n    if (this._options.logger && subprocess.stderr) {\n      readline.createInterface(subprocess.stderr).on(\"line\", (line) => {\n        try {\n          // we purposefully extract and ignore the `ts` field\n          // eslint-disable-next-line @typescript-eslint/no-unused-vars\n          const { level, msg, ts, ...fields } = JSON.parse(line) as {\n            [key: string]: unknown;\n            level: \"debug\" | \"info\" | \"warn\" | \"error\";\n            msg: string;\n            ts: string | number;\n          };\n\n          this._options.logger?.log(level, msg, fields);\n        } catch (error) {\n          this._options.logger?.log(\"warn\", \"failed to log line\", { error, line });\n        }\n      });\n    }\n\n    return subprocess;\n  }\n}\n"]}

package/dist/esm/grpc-client.js

@@ -138,6 +138,7 @@ export class DateiLagerGrpcClient {
                         path,
                         ignores,
                         isPrefix: true,
+                        subpaths: [],
                     },
                 ],
             }, this._rpcOptions()));
@@ -177,7 +178,7 @@ export class DateiLagerGrpcClient {
                 "dl.to_version": String(to),
             },
         }, async () => {
-            const call = this._client.getUnary({ project, fromVersion: from, toVersion: to, queries: [{ path, ignores, isPrefix: true }] }, this._rpcOptions());
+            const call = this._client.getUnary({ project, fromVersion: from, toVersion: to, queries: [{ path, ignores, isPrefix: true, subpaths: [] }] }, this._rpcOptions());
             return await call.response;
         });
     }
@@ -207,6 +208,7 @@ export class DateiLagerGrpcClient {
                         path,
                         isPrefix: false,
                         ignores: [],
+                        subpaths: [],
                     },
                 ],
             }, this._rpcOptions());

package/dist/esm/grpc-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"grpc-client.js","sourceRoot":"","sources":["../../src/grpc-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAA6C,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AA0C3D;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAU/B;;;;OAIG;IACH,YAAmB,OAAoC;QAdvD,gBAAgB;QACC;;;;;WAAkB;QAEnC,gBAAgB;QACC;;;;;WAA0B;QAE3C,gBAAgB;QACC;;;;;WAA0C;QAQzD,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAEnH,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC;YAClC,IAAI,EAAE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE;YAC3G,kBAAkB,EAAE,WAAW,CAAC,yBAAyB,CACvD,kBAAkB,CAAC,SAAS,EAAE,EAC9B,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE;gBACtD,OAAO,EAAE;qBACN,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;oBACd,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC5B,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;oBAC7C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACvB,CAAC,CAAC;qBACD,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC,CAAC,CACH;YACD,aAAa,EAAE;gBACb,wBAAwB,EAAE,IAAK;gBAC/B,2BAA2B,EAAE,IAAK;gBAClC,qCAAqC,EAAE,CAAC;gBACxC,GAAG,OAAO,CAAC,iBAAiB;aAC7B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE7C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,YAAY,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAoC,CAAC;IACtI,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,YAAsB,EAAE,QAAiB;QAChF,IAAI,CAAC;YACH,MAAM,KAAK,CACT,oCAAoC,EACpC;gBACE,UAAU,EAAE;oBACV,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;oBAC7B,kBAAkB,EAAE,YAAY;oBAChC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC;iBAChC;aACF,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAC3F,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;gBAChE,MAAM,IAAI,yBAAyB,CAAC,cAAc,OAAO,iBAAiB,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,aAAa,CAAC,OAAe;QACxC,MAAM,KAAK,CACT,uCAAuC,EACvC;YACE,UAAU,EAAE;gBACV,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;aAC9B;SACF,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAClE,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,CAAC,WAAW,CACvB,OAAe,EACf,IAAY,EACZ,UAAoB,EAAE,EACtB,IAAa,EACb,EAAW;QAEX,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAC3B,qCAAqC,EACrC;YACE,UAAU,EAAE;gBACV,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;gBAC7B,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,OAAO;gBACrB,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC;gBAC/B,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;aAC5B;SACF,EACD,aAAa,CACd,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CACvE,IAAI,CAAC,OAAO,CAAC,GAAG,CACd;gBACE,OAAO;gBACP,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI;wBACJ,OAAO;wBACP,QAAQ,EAAE,IAAI;qBACf;iBACF;aACF,EACD,IAAI,CAAC,WAAW,EAAE,CACnB,CACF,CAAC;YAEF,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC5C,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACpB,MAAM,QAAQ,CAAC,MAAM,CAAC;gBACxB,CAAC;YACH,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,IAAY,EAAE,UAAoB,EAAE,EAAE,IAAa,EAAE,EAAW;QACvG,OAAO,MAAM,KAAK,CAChB,kCAAkC,EAClC;YACE,UAAU,EAAE;gBACV,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;gBAC7B,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,OAAO;gBACrB,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC;gBAC/B,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;aAC5B;SACF,EACD,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAChC,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,EAC3F,IAAI,CAAC,WAAW,EAAE,CACnB,CAAC;YACF,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC;QAC7B,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,IAAY,EAAE,IAAa,EAAE,EAAW;QAC9E,OAAO,MAAM,KAAK,CAChB,mCAAmC,EACnC;YACE,UAAU,EAAE;gBACV,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;gBAC7B,SAAS,EAAE,IAAI;gBACf,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC;gBAC/B,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;aAC5B;SACF,EACD,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAC3B;gBACE,OAAO;gBACP,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI;wBACJ,QAAQ,EAAE,KAAK;wBACf,OAAO,EAAE,EAAE;qBACZ;iBACF;aACF,EACD,IAAI,CAAC,WAAW,EAAE,CACnB,CAAC;YAEF,IAAI,MAA0B,CAAC;YAC/B,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC5C,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC3B,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,CAAC;YAElB,OAAO,MAAM,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAC,OAAe;QAClC,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAC3B,uCAAuC,EACvC;YACE,UAAU,EAAE;gBACV,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;aAC9B;SACF,EACD,aAAa,CACd,CAAC;QAEF,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAEnH,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,GAAW;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,OAAe;QAC3D,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,oBAAoB;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,2BAA2B,CAAC,QAAmB;QAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,MAAc,EAAE,OAAe;QACzE,OAAO,MAAM,KAAK,CAChB,yCAAyC,EACzC;YACE,UAAU,EAAE;gBACV,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC3B,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;aAC9B;SACF,EACD,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAChG,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,IAAY,EAAE,IAAa;QACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YACxC,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,IAAY,EAAE,IAAa;QACvE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC/C,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,UAAU,CAAC,MAAc;QACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YACzC,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,iBAAiB;IAUrB,YAAmB,OAAe,EAAE,IAAwD,EAAE,IAAU;QATxG,gBAAgB;QACC;;;;;WAAiB;QAElC,gBAAgB;QACC;;;;;WAA0D;QAE3E,gBAAgB;QACC;;;;;WAAY;QAG3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,IAAI,CAAC,GAAW;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC7B,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,MAAM,EAAE,GAAG;aACZ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC3C,OAAO,QAAQ,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAA6B;IACzD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["import type { ClientOptions } from \"@grpc/grpc-js\";\nimport { ChannelCredentials, credentials, Metadata } from \"@grpc/grpc-js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { context as contextAPI, trace as traceAPI } from \"@opentelemetry/api\";\nimport { GrpcTransport } from \"@protobuf-ts/grpc-transport\";\nimport { RpcError, type ClientStreamingCall, type RpcOptions } from \"@protobuf-ts/runtime-rpc\";\nimport { TextDecoder, TextEncoder } from \"util\";\nimport { trace, tracer } from \"./internal/telemetry\";\nimport type { CloneToProjectResponse, GetUnaryResponse, Objekt, Project, UpdateRequest, UpdateResponse } from \"./pb/fs_pb\";\nimport { FsClient } from \"./pb/fs_pb.client\";\nimport { ProjectAlreadyExistsError } from \"./utils/errors\";\nexport type { Objekt, Project };\n\n/**\n * Options for {@link DateiLagerGrpcClient}.\n */\nexport interface DateiLagerGrpcClientOptions {\n  /**\n   * The address of the dateilager server.\n   */\n  server:\n    | string\n    | {\n        /**\n         * The host of the dateilager server.\n         */\n        host: string;\n\n        /**\n         * The port of the dateilager server.\n         */\n        port: number;\n      };\n\n  /**\n   * The token that will be sent as authorization metadata to the dateilager server.\n   */\n  token: string | (() => Promise<string>);\n\n  /**\n   * Options that will be passed to the underlying grpc client constructor.\n   * @see ClientOptions\n   */\n  grpcClientOptions?: ClientOptions;\n\n  /**\n   * Options that will be passed to every remote procedure call.\n   * @see RpcOptions\n   */\n  rpcOptions?: RpcOptions | (() => RpcOptions | undefined);\n}\n\n/**\n * A client class for interacting with DateiLager's GRPC API.\n *\n * The DateiLager API surface area is as minimal as possible;\n * convenience functions, such as getObject, should be implemented within the client.\n */\nexport class DateiLagerGrpcClient {\n  /** @internal */\n  private readonly _client: FsClient;\n\n  /** @internal */\n  private readonly _transport: GrpcTransport;\n\n  /** @internal */\n  private readonly _rpcOptions: () => RpcOptions | undefined;\n\n  /**\n   * The library used to interact with GRPC creates connections lazily, this constructor will not\n   * raise an error even if there is no service running at {@link DateiLagerGrpcClientOptions.server server}.\n   * @param options Grpc client options.\n   */\n  public constructor(options: DateiLagerGrpcClientOptions) {\n    const tokenFn = typeof options.token === \"string\" ? () => Promise.resolve(options.token as string) : options.token;\n\n    this._transport = new GrpcTransport({\n      host: typeof options.server === \"string\" ? options.server : `${options.server.host}:${options.server.port}`,\n      channelCredentials: credentials.combineChannelCredentials(\n        ChannelCredentials.createSsl(),\n        credentials.createFromMetadataGenerator((_, callback) => {\n          tokenFn()\n            .then((token) => {\n              const meta = new Metadata();\n              meta.add(\"authorization\", `Bearer ${token}`);\n              callback(null, meta);\n            })\n            .catch(callback);\n        })\n      ),\n      clientOptions: {\n        \"grpc.keepalive_time_ms\": 5_000,\n        \"grpc.keepalive_timeout_ms\": 1_000,\n        \"grpc.keepalive_permit_without_calls\": 1,\n        ...options.grpcClientOptions,\n      },\n    });\n\n    this._client = new FsClient(this._transport);\n\n    this._rpcOptions = options.rpcOptions instanceof Function ? options.rpcOptions : () => options.rpcOptions as RpcOptions | undefined;\n  }\n\n  /**\n   * Close the underlying GRPC client.\n   */\n  public close(): void {\n    this._transport.close();\n  }\n\n  /**\n   * Create a new project.\n   * @param project      The id of the project.\n   * @param packPatterns The paths to pack.\n   * @param template     The id of the project to start from.\n   */\n  public async newProject(project: bigint, packPatterns: string[], template?: bigint): Promise<void> {\n    try {\n      await trace(\n        \"dateilager-grpc-client.new-project\",\n        {\n          attributes: {\n            \"dl.project\": String(project),\n            \"dl.pack_patterns\": packPatterns,\n            \"dl.template\": String(template),\n          },\n        },\n        () => this._client.newProject({ id: project, packPatterns, template }, this._rpcOptions())\n      );\n    } catch (error) {\n      if (error instanceof RpcError && error.code == \"ALREADY_EXISTS\") {\n        throw new ProjectAlreadyExistsError(`project id ${project} already exists`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Delete a project.\n   * @param project The id of the project.\n   */\n  public async deleteProject(project: bigint): Promise<void> {\n    await trace(\n      \"dateilager-grpc-client.delete-project\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n        },\n      },\n      () => this._client.deleteProject({ project }, this._rpcOptions())\n    );\n  }\n\n  /**\n   * List objects.\n   * @param  project The id of the project.\n   * @param  path    The path to list objects under.\n   * @param  ignores The paths under {@link path} to ignore.\n   * @param  from    The project version to start from.\n   * @param  to      The project version to end at.\n   * @returns        A stream of objects.\n   * @yields           An object from the stream.\n   * @example\n   * for await (const object of client.listObjects(1n, \"\")) {\n   *   console.log(\"[listObjects] path: \" + object.path);\n   *   console.log(\"[listObjects] content:\\n\" + object.content);\n   * }\n   */\n  public async *listObjects(\n    project: bigint,\n    path: string,\n    ignores: string[] = [],\n    from?: bigint,\n    to?: bigint\n  ): AsyncGenerator<Objekt, void> {\n    const parentContext = contextAPI.active();\n    const span = tracer.startSpan(\n      \"dateilager-grpc-client.list-objects\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.path\": path,\n          \"dl.ignores\": ignores,\n          \"dl.from_version\": String(from),\n          \"dl.to_version\": String(to),\n        },\n      },\n      parentContext\n    );\n\n    try {\n      const call = contextAPI.with(traceAPI.setSpan(parentContext, span), () =>\n        this._client.get(\n          {\n            project,\n            fromVersion: from,\n            toVersion: to,\n            queries: [\n              {\n                path,\n                ignores,\n                isPrefix: true,\n              },\n            ],\n          },\n          this._rpcOptions()\n        )\n      );\n\n      for await (const response of call.responses) {\n        if (response.object) {\n          yield response.object;\n        }\n      }\n\n      await call.status;\n    } finally {\n      span.end();\n    }\n  }\n\n  /**\n   * Get objects.\n   * @param project The id of the project.\n   * @param path    The path to get objects under.\n   * @param ignores The paths under {@link path} to ignore.\n   * @param from    The project version to start from.\n   * @param to      The project version to end at.\n   * @returns       All the objects under {@link path}.\n   * @example\n   * const response = await client.getObjects(1n, \"\");\n   * for (const object of response.objects) {\n   *   console.log(\"[getObjects] path: \" + object.path);\n   *   console.log(\"[getObjects] content:\\n\" + object.content);\n   * }\n   */\n  public async getObjects(project: bigint, path: string, ignores: string[] = [], from?: bigint, to?: bigint): Promise<GetUnaryResponse> {\n    return await trace(\n      \"dateilager-grpc-client.get-unary\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.path\": path,\n          \"dl.ignores\": ignores,\n          \"dl.from_version\": String(from),\n          \"dl.to_version\": String(to),\n        },\n      },\n      async () => {\n        const call = this._client.getUnary(\n          { project, fromVersion: from, toVersion: to, queries: [{ path, ignores, isPrefix: true }] },\n          this._rpcOptions()\n        );\n        return await call.response;\n      }\n    );\n  }\n\n  /**\n   * Get an object.\n   * @param project The id of the project.\n   * @param path    The path of the object.\n   * @param from    The project version to start from.\n   * @param to      The project version to end at.\n   * @returns       The object at the given path or undefined if it does not exist.\n   */\n  public async getObject(project: bigint, path: string, from?: bigint, to?: bigint): Promise<Objekt | undefined> {\n    return await trace(\n      \"dateilager-grpc-client.get-object\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.path\": path,\n          \"dl.from_version\": String(from),\n          \"dl.to_version\": String(to),\n        },\n      },\n      async () => {\n        const call = this._client.get(\n          {\n            project,\n            fromVersion: from,\n            toVersion: to,\n            queries: [\n              {\n                path,\n                isPrefix: false,\n                ignores: [],\n              },\n            ],\n          },\n          this._rpcOptions()\n        );\n\n        let object: Objekt | undefined;\n        for await (const response of call.responses) {\n          object = response.object;\n        }\n\n        await call.status;\n\n        return object;\n      }\n    );\n  }\n\n  /**\n   * Update objects.\n   * @param project The id of the project.\n   * @returns       An {@link UpdateInputStream} to send objects to update.\n   */\n  public updateObjects(project: bigint): UpdateInputStream {\n    const parentContext = contextAPI.active();\n    const span = tracer.startSpan(\n      \"dateilager-grpc-client.update-objects\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n        },\n      },\n      parentContext\n    );\n\n    const call = contextAPI.with(traceAPI.setSpan(parentContext, span), () => this._client.update(this._rpcOptions()));\n\n    return new UpdateInputStream(project, call, span);\n  }\n\n  /**\n   * Update an object.\n   * @param project The id of the project.\n   * @param obj     The object to update.\n   * @returns       The latest project version or `null` if something went wrong.\n   */\n  public async updateObject(project: bigint, obj: Objekt): Promise<bigint | null> {\n    const stream = this.updateObjects(project);\n    await stream.send(obj);\n    return await stream.complete();\n  }\n\n  /**\n   * Rollback a project.\n   * @param project The id of the project.\n   * @param version The version to rollback to.\n   */\n  public async rollbackProject(project: bigint, version: bigint): Promise<void> {\n    await this._client.rollback({ project, version }, this._rpcOptions());\n  }\n\n  /**\n   * Snapshot the current state of the dateilager server.\n   * @returns All the projects on the dateilager server.\n   * @throws If the dateilager server's DL_ENV environment variable is PROD.\n   * @see DateiLagerGrpcClient.resetToSnapshotInDevOrTests\n   */\n  public async snapshotInDevOrTests(): Promise<Project[]> {\n    const call = await this._client.snapshot({}, this._rpcOptions());\n    return call.response.projects;\n  }\n\n  /**\n   * Reset the given projects to their respective versions and delete any remaining projects.\n   * If no projects are provided, delete all projects.\n   * @param projects The projects to reset.\n   * @throws If the dateilager server's DL_ENV environment variable is PROD.\n   * @see DateiLagerGrpcClient.snapshotInDevOrTests\n   */\n  public async resetToSnapshotInDevOrTests(projects: Project[]): Promise<void> {\n    await this._client.reset({ projects }, this._rpcOptions());\n  }\n\n  /**\n   * Clones the `source` projects changes (from `fromVersion` up to `toVersion`) to the `target` project.\n   * This method assumes that it is always a one way clone from source to target, it does not take into account\n   * the changes that have occurred in the `target` project.\n   * @param source  The source project.\n   * @param target  The target project.\n   * @param version The version of the source project to clone up to.\n   * @returns       The new version number of the target project.\n   */\n  public async cloneToProject(source: bigint, target: bigint, version: bigint): Promise<CloneToProjectResponse> {\n    return await trace(\n      \"dateilager-grpc-client.clone-to-project\",\n      {\n        attributes: {\n          \"dl.source\": String(source),\n          \"dl.target\": String(target),\n          \"dl.version\": String(version),\n        },\n      },\n      async () => {\n        const call = await this._client.cloneToProject({ source, target, version }, this._rpcOptions());\n        return call.response;\n      }\n    );\n  }\n\n  /**\n   * GC project.\n   * @param project The project to GC.\n   * @param keep    The amount of versions since the latest that should be kept.\n   * @param from    The starting version to GC from.\n   * @returns       The amount of objects that were GC'd.\n   */\n  public async gcProject(project: bigint, keep: bigint, from?: bigint): Promise<bigint> {\n    const call = await this._client.gcProject({\n      project: project,\n      keepVersions: keep,\n      fromVersion: from,\n    });\n    return call.response.count;\n  }\n\n  /**\n   * GC random projects.\n   * @param sample The percentage of projects to sample from.\n   * @param keep   The amount of versions since the latest that should be kept.\n   * @param from   The starting version to GC from.\n   * @returns      The amount of objects that were GC'd.\n   */\n  public async gcRandomProjects(sample: number, keep: bigint, from?: bigint): Promise<bigint> {\n    const call = await this._client.gcRandomProjects({\n      sample: sample,\n      keepVersions: keep,\n      fromVersion: from,\n    });\n    return call.response.count;\n  }\n\n  /**\n   * GC contents.\n   * @param sample The percentage of projects to sample from.\n   * @returns      The amount of objects that were GC'd.\n   */\n  public async gcContents(sample: number): Promise<bigint> {\n    const call = await this._client.gcContents({\n      sample: sample,\n    });\n    return call.response.count;\n  }\n}\n\n/**\n * Used to send a stream of objects to update.\n * @see DateiLagerGrpcClient.updateObjects\n */\nclass UpdateInputStream {\n  /** @internal */\n  private readonly _project: bigint;\n\n  /** @internal */\n  private readonly _call: ClientStreamingCall<UpdateRequest, UpdateResponse>;\n\n  /** @internal */\n  private readonly _span: Span;\n\n  public constructor(project: bigint, call: ClientStreamingCall<UpdateRequest, UpdateResponse>, span: Span) {\n    this._project = project;\n    this._call = call;\n    this._span = span;\n  }\n\n  /**\n   * Send an object to update.\n   * @param obj The object to update.\n   */\n  public async send(obj: Objekt): Promise<void> {\n    try {\n      await this._call.requests.send({\n        project: this._project,\n        object: obj,\n      });\n    } catch (err) {\n      this._span.end();\n      throw err;\n    }\n  }\n\n  /**\n   * Complete the update request.\n   * @returns The latest project version or `null` if something went wrong.\n   */\n  public async complete(): Promise<bigint | null> {\n    try {\n      await this._call.requests.complete();\n      const response = await this._call.response;\n      return response.version != -1n ? response.version : null;\n    } finally {\n      this._span.end();\n    }\n  }\n}\n\nconst encoder = new TextEncoder();\n\n/**\n * Encode string object contents as an array of bytes.\n * @param content The string to encode.\n * @returns       The encoded content as an array of bytes.\n */\nexport function encodeContent(content: string): Uint8Array {\n  return encoder.encode(content);\n}\n\nconst decoder = new TextDecoder();\n\n/**\n * Decode an array of bytes as an object's string contents.\n * @param bytes The array of bytes to decode.\n * @returns     The bytes decoded into a string.\n */\nexport function decodeContent(bytes: Uint8Array | undefined): string {\n  return decoder.decode(bytes);\n}\n"]}
+{"version":3,"file":"grpc-client.js","sourceRoot":"","sources":["../../src/grpc-client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ClientOptions } from \"@grpc/grpc-js\";\nimport { ChannelCredentials, credentials, Metadata } from \"@grpc/grpc-js\";\nimport type { Span } from \"@opentelemetry/api\";\nimport { context as contextAPI, trace as traceAPI } from \"@opentelemetry/api\";\nimport { GrpcTransport } from \"@protobuf-ts/grpc-transport\";\nimport { RpcError, type ClientStreamingCall, type RpcOptions } from \"@protobuf-ts/runtime-rpc\";\nimport { TextDecoder, TextEncoder } from \"util\";\nimport { trace, tracer } from \"./internal/telemetry\";\nimport type { CloneToProjectResponse, GetUnaryResponse, Objekt, Project, UpdateRequest, UpdateResponse } from \"./pb/fs_pb\";\nimport { FsClient } from \"./pb/fs_pb.client\";\nimport { ProjectAlreadyExistsError } from \"./utils/errors\";\nexport type { Objekt, Project };\n\n/**\n * Options for {@link DateiLagerGrpcClient}.\n */\nexport interface DateiLagerGrpcClientOptions {\n  /**\n   * The address of the dateilager server.\n   */\n  server:\n    | string\n    | {\n        /**\n         * The host of the dateilager server.\n         */\n        host: string;\n\n        /**\n         * The port of the dateilager server.\n         */\n        port: number;\n      };\n\n  /**\n   * The token that will be sent as authorization metadata to the dateilager server.\n   */\n  token: string | (() => Promise<string>);\n\n  /**\n   * Options that will be passed to the underlying grpc client constructor.\n   * @see ClientOptions\n   */\n  grpcClientOptions?: ClientOptions;\n\n  /**\n   * Options that will be passed to every remote procedure call.\n   * @see RpcOptions\n   */\n  rpcOptions?: RpcOptions | (() => RpcOptions | undefined);\n}\n\n/**\n * A client class for interacting with DateiLager's GRPC API.\n *\n * The DateiLager API surface area is as minimal as possible;\n * convenience functions, such as getObject, should be implemented within the client.\n */\nexport class DateiLagerGrpcClient {\n  /** @internal */\n  private readonly _client: FsClient;\n\n  /** @internal */\n  private readonly _transport: GrpcTransport;\n\n  /** @internal */\n  private readonly _rpcOptions: () => RpcOptions | undefined;\n\n  /**\n   * The library used to interact with GRPC creates connections lazily, this constructor will not\n   * raise an error even if there is no service running at {@link DateiLagerGrpcClientOptions.server server}.\n   * @param options Grpc client options.\n   */\n  public constructor(options: DateiLagerGrpcClientOptions) {\n    const tokenFn = typeof options.token === \"string\" ? () => Promise.resolve(options.token as string) : options.token;\n\n    this._transport = new GrpcTransport({\n      host: typeof options.server === \"string\" ? options.server : `${options.server.host}:${options.server.port}`,\n      channelCredentials: credentials.combineChannelCredentials(\n        ChannelCredentials.createSsl(),\n        credentials.createFromMetadataGenerator((_, callback) => {\n          tokenFn()\n            .then((token) => {\n              const meta = new Metadata();\n              meta.add(\"authorization\", `Bearer ${token}`);\n              callback(null, meta);\n            })\n            .catch(callback);\n        })\n      ),\n      clientOptions: {\n        \"grpc.keepalive_time_ms\": 5_000,\n        \"grpc.keepalive_timeout_ms\": 1_000,\n        \"grpc.keepalive_permit_without_calls\": 1,\n        ...options.grpcClientOptions,\n      },\n    });\n\n    this._client = new FsClient(this._transport);\n\n    this._rpcOptions = options.rpcOptions instanceof Function ? options.rpcOptions : () => options.rpcOptions as RpcOptions | undefined;\n  }\n\n  /**\n   * Close the underlying GRPC client.\n   */\n  public close(): void {\n    this._transport.close();\n  }\n\n  /**\n   * Create a new project.\n   * @param project      The id of the project.\n   * @param packPatterns The paths to pack.\n   * @param template     The id of the project to start from.\n   */\n  public async newProject(project: bigint, packPatterns: string[], template?: bigint): Promise<void> {\n    try {\n      await trace(\n        \"dateilager-grpc-client.new-project\",\n        {\n          attributes: {\n            \"dl.project\": String(project),\n            \"dl.pack_patterns\": packPatterns,\n            \"dl.template\": String(template),\n          },\n        },\n        () => this._client.newProject({ id: project, packPatterns, template }, this._rpcOptions())\n      );\n    } catch (error) {\n      if (error instanceof RpcError && error.code == \"ALREADY_EXISTS\") {\n        throw new ProjectAlreadyExistsError(`project id ${project} already exists`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Delete a project.\n   * @param project The id of the project.\n   */\n  public async deleteProject(project: bigint): Promise<void> {\n    await trace(\n      \"dateilager-grpc-client.delete-project\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n        },\n      },\n      () => this._client.deleteProject({ project }, this._rpcOptions())\n    );\n  }\n\n  /**\n   * List objects.\n   * @param  project The id of the project.\n   * @param  path    The path to list objects under.\n   * @param  ignores The paths under {@link path} to ignore.\n   * @param  from    The project version to start from.\n   * @param  to      The project version to end at.\n   * @returns        A stream of objects.\n   * @yields           An object from the stream.\n   * @example\n   * for await (const object of client.listObjects(1n, \"\")) {\n   *   console.log(\"[listObjects] path: \" + object.path);\n   *   console.log(\"[listObjects] content:\\n\" + object.content);\n   * }\n   */\n  public async *listObjects(\n    project: bigint,\n    path: string,\n    ignores: string[] = [],\n    from?: bigint,\n    to?: bigint\n  ): AsyncGenerator<Objekt, void> {\n    const parentContext = contextAPI.active();\n    const span = tracer.startSpan(\n      \"dateilager-grpc-client.list-objects\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.path\": path,\n          \"dl.ignores\": ignores,\n          \"dl.from_version\": String(from),\n          \"dl.to_version\": String(to),\n        },\n      },\n      parentContext\n    );\n\n    try {\n      const call = contextAPI.with(traceAPI.setSpan(parentContext, span), () =>\n        this._client.get(\n          {\n            project,\n            fromVersion: from,\n            toVersion: to,\n            queries: [\n              {\n                path,\n                ignores,\n                isPrefix: true,\n                subpaths: [],\n              },\n            ],\n          },\n          this._rpcOptions()\n        )\n      );\n\n      for await (const response of call.responses) {\n        if (response.object) {\n          yield response.object;\n        }\n      }\n\n      await call.status;\n    } finally {\n      span.end();\n    }\n  }\n\n  /**\n   * Get objects.\n   * @param project The id of the project.\n   * @param path    The path to get objects under.\n   * @param ignores The paths under {@link path} to ignore.\n   * @param from    The project version to start from.\n   * @param to      The project version to end at.\n   * @returns       All the objects under {@link path}.\n   * @example\n   * const response = await client.getObjects(1n, \"\");\n   * for (const object of response.objects) {\n   *   console.log(\"[getObjects] path: \" + object.path);\n   *   console.log(\"[getObjects] content:\\n\" + object.content);\n   * }\n   */\n  public async getObjects(project: bigint, path: string, ignores: string[] = [], from?: bigint, to?: bigint): Promise<GetUnaryResponse> {\n    return await trace(\n      \"dateilager-grpc-client.get-unary\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.path\": path,\n          \"dl.ignores\": ignores,\n          \"dl.from_version\": String(from),\n          \"dl.to_version\": String(to),\n        },\n      },\n      async () => {\n        const call = this._client.getUnary(\n          { project, fromVersion: from, toVersion: to, queries: [{ path, ignores, isPrefix: true, subpaths: [] }] },\n          this._rpcOptions()\n        );\n        return await call.response;\n      }\n    );\n  }\n\n  /**\n   * Get an object.\n   * @param project The id of the project.\n   * @param path    The path of the object.\n   * @param from    The project version to start from.\n   * @param to      The project version to end at.\n   * @returns       The object at the given path or undefined if it does not exist.\n   */\n  public async getObject(project: bigint, path: string, from?: bigint, to?: bigint): Promise<Objekt | undefined> {\n    return await trace(\n      \"dateilager-grpc-client.get-object\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n          \"dl.path\": path,\n          \"dl.from_version\": String(from),\n          \"dl.to_version\": String(to),\n        },\n      },\n      async () => {\n        const call = this._client.get(\n          {\n            project,\n            fromVersion: from,\n            toVersion: to,\n            queries: [\n              {\n                path,\n                isPrefix: false,\n                ignores: [],\n                subpaths: [],\n              },\n            ],\n          },\n          this._rpcOptions()\n        );\n\n        let object: Objekt | undefined;\n        for await (const response of call.responses) {\n          object = response.object;\n        }\n\n        await call.status;\n\n        return object;\n      }\n    );\n  }\n\n  /**\n   * Update objects.\n   * @param project The id of the project.\n   * @returns       An {@link UpdateInputStream} to send objects to update.\n   */\n  public updateObjects(project: bigint): UpdateInputStream {\n    const parentContext = contextAPI.active();\n    const span = tracer.startSpan(\n      \"dateilager-grpc-client.update-objects\",\n      {\n        attributes: {\n          \"dl.project\": String(project),\n        },\n      },\n      parentContext\n    );\n\n    const call = contextAPI.with(traceAPI.setSpan(parentContext, span), () => this._client.update(this._rpcOptions()));\n\n    return new UpdateInputStream(project, call, span);\n  }\n\n  /**\n   * Update an object.\n   * @param project The id of the project.\n   * @param obj     The object to update.\n   * @returns       The latest project version or `null` if something went wrong.\n   */\n  public async updateObject(project: bigint, obj: Objekt): Promise<bigint | null> {\n    const stream = this.updateObjects(project);\n    await stream.send(obj);\n    return await stream.complete();\n  }\n\n  /**\n   * Rollback a project.\n   * @param project The id of the project.\n   * @param version The version to rollback to.\n   */\n  public async rollbackProject(project: bigint, version: bigint): Promise<void> {\n    await this._client.rollback({ project, version }, this._rpcOptions());\n  }\n\n  /**\n   * Snapshot the current state of the dateilager server.\n   * @returns All the projects on the dateilager server.\n   * @throws If the dateilager server's DL_ENV environment variable is PROD.\n   * @see DateiLagerGrpcClient.resetToSnapshotInDevOrTests\n   */\n  public async snapshotInDevOrTests(): Promise<Project[]> {\n    const call = await this._client.snapshot({}, this._rpcOptions());\n    return call.response.projects;\n  }\n\n  /**\n   * Reset the given projects to their respective versions and delete any remaining projects.\n   * If no projects are provided, delete all projects.\n   * @param projects The projects to reset.\n   * @throws If the dateilager server's DL_ENV environment variable is PROD.\n   * @see DateiLagerGrpcClient.snapshotInDevOrTests\n   */\n  public async resetToSnapshotInDevOrTests(projects: Project[]): Promise<void> {\n    await this._client.reset({ projects }, this._rpcOptions());\n  }\n\n  /**\n   * Clones the `source` projects changes (from `fromVersion` up to `toVersion`) to the `target` project.\n   * This method assumes that it is always a one way clone from source to target, it does not take into account\n   * the changes that have occurred in the `target` project.\n   * @param source  The source project.\n   * @param target  The target project.\n   * @param version The version of the source project to clone up to.\n   * @returns       The new version number of the target project.\n   */\n  public async cloneToProject(source: bigint, target: bigint, version: bigint): Promise<CloneToProjectResponse> {\n    return await trace(\n      \"dateilager-grpc-client.clone-to-project\",\n      {\n        attributes: {\n          \"dl.source\": String(source),\n          \"dl.target\": String(target),\n          \"dl.version\": String(version),\n        },\n      },\n      async () => {\n        const call = await this._client.cloneToProject({ source, target, version }, this._rpcOptions());\n        return call.response;\n      }\n    );\n  }\n\n  /**\n   * GC project.\n   * @param project The project to GC.\n   * @param keep    The amount of versions since the latest that should be kept.\n   * @param from    The starting version to GC from.\n   * @returns       The amount of objects that were GC'd.\n   */\n  public async gcProject(project: bigint, keep: bigint, from?: bigint): Promise<bigint> {\n    const call = await this._client.gcProject({\n      project: project,\n      keepVersions: keep,\n      fromVersion: from,\n    });\n    return call.response.count;\n  }\n\n  /**\n   * GC random projects.\n   * @param sample The percentage of projects to sample from.\n   * @param keep   The amount of versions since the latest that should be kept.\n   * @param from   The starting version to GC from.\n   * @returns      The amount of objects that were GC'd.\n   */\n  public async gcRandomProjects(sample: number, keep: bigint, from?: bigint): Promise<bigint> {\n    const call = await this._client.gcRandomProjects({\n      sample: sample,\n      keepVersions: keep,\n      fromVersion: from,\n    });\n    return call.response.count;\n  }\n\n  /**\n   * GC contents.\n   * @param sample The percentage of projects to sample from.\n   * @returns      The amount of objects that were GC'd.\n   */\n  public async gcContents(sample: number): Promise<bigint> {\n    const call = await this._client.gcContents({\n      sample: sample,\n    });\n    return call.response.count;\n  }\n}\n\n/**\n * Used to send a stream of objects to update.\n * @see DateiLagerGrpcClient.updateObjects\n */\nclass UpdateInputStream {\n  /** @internal */\n  private readonly _project: bigint;\n\n  /** @internal */\n  private readonly _call: ClientStreamingCall<UpdateRequest, UpdateResponse>;\n\n  /** @internal */\n  private readonly _span: Span;\n\n  public constructor(project: bigint, call: ClientStreamingCall<UpdateRequest, UpdateResponse>, span: Span) {\n    this._project = project;\n    this._call = call;\n    this._span = span;\n  }\n\n  /**\n   * Send an object to update.\n   * @param obj The object to update.\n   */\n  public async send(obj: Objekt): Promise<void> {\n    try {\n      await this._call.requests.send({\n        project: this._project,\n        object: obj,\n      });\n    } catch (err) {\n      this._span.end();\n      throw err;\n    }\n  }\n\n  /**\n   * Complete the update request.\n   * @returns The latest project version or `null` if something went wrong.\n   */\n  public async complete(): Promise<bigint | null> {\n    try {\n      await this._call.requests.complete();\n      const response = await this._call.response;\n      return response.version != -1n ? response.version : null;\n    } finally {\n      this._span.end();\n    }\n  }\n}\n\nconst encoder = new TextEncoder();\n\n/**\n * Encode string object contents as an array of bytes.\n * @param content The string to encode.\n * @returns       The encoded content as an array of bytes.\n */\nexport function encodeContent(content: string): Uint8Array {\n  return encoder.encode(content);\n}\n\nconst decoder = new TextDecoder();\n\n/**\n * Decode an array of bytes as an object's string contents.\n * @param bytes The array of bytes to decode.\n * @returns     The bytes decoded into a string.\n */\nexport function decodeContent(bytes: Uint8Array | undefined): string {\n  return decoder.decode(bytes);\n}\n"]}

package/dist/esm/pb/fs_pb.d.ts

@@ -111,6 +111,10 @@ export interface ObjectQuery {
      * @generated from protobuf field: repeated string ignores = 4;
      */
     ignores: string[];
+    /**
+     * @generated from protobuf field: repeated string subpaths = 5;
+     */
+    subpaths: string[];
 }
 /**
  * @generated from protobuf message pb.GetRequest

package/dist/esm/pb/fs_pb.js

@@ -398,7 +398,8 @@ class ObjectQuery$Type extends MessageType {
         super("pb.ObjectQuery", [
             { no: 1, name: "path", kind: "scalar", T: 9 /*ScalarType.STRING*/ },
             { no: 2, name: "is_prefix", kind: "scalar", T: 8 /*ScalarType.BOOL*/ },
-            { no: 4, name: "ignores", kind: "scalar", repeat: 2 /*RepeatType.UNPACKED*/, T: 9 /*ScalarType.STRING*/ }
+            { no: 4, name: "ignores", kind: "scalar", repeat: 2 /*RepeatType.UNPACKED*/, T: 9 /*ScalarType.STRING*/ },
+            { no: 5, name: "subpaths", kind: "scalar", repeat: 2 /*RepeatType.UNPACKED*/, T: 9 /*ScalarType.STRING*/ }
         ]);
     }
     create(value) {
@@ -406,6 +407,7 @@ class ObjectQuery$Type extends MessageType {
         message.path = "";
         message.isPrefix = false;
         message.ignores = [];
+        message.subpaths = [];
         if (value !== undefined)
             reflectionMergePartial(this, message, value);
         return message;
@@ -424,6 +426,9 @@ class ObjectQuery$Type extends MessageType {
                 case /* repeated string ignores */ 4:
                     message.ignores.push(reader.string());
                     break;
+                case /* repeated string subpaths */ 5:
+                    message.subpaths.push(reader.string());
+                    break;
                 default:
                     let u = options.readUnknownField;
                     if (u === "throw")
@@ -445,6 +450,9 @@ class ObjectQuery$Type extends MessageType {
         /* repeated string ignores = 4; */
         for (let i = 0; i < message.ignores.length; i++)
             writer.tag(4, WireType.LengthDelimited).string(message.ignores[i]);
+        /* repeated string subpaths = 5; */
+        for (let i = 0; i < message.subpaths.length; i++)
+            writer.tag(5, WireType.LengthDelimited).string(message.subpaths[i]);
         let u = options.writeUnknownFields;
         if (u !== false)
             (u == true ? UnknownFieldHandler.onWrite : u)(this.typeName, message, writer);