@arke-institute/sdk 0.1.1 → 0.1.3

package/dist/query/index.js

@@ -0,0 +1,328 @@
+// src/query/errors.ts
+var QueryError = class extends Error {
+  constructor(message, code = "UNKNOWN_ERROR", details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "QueryError";
+  }
+};
+
+// src/query/client.ts
+var QueryClient = class {
+  constructor(config) {
+    this.baseUrl = config.gatewayUrl.replace(/\/$/, "");
+    this.fetchImpl = config.fetchImpl ?? fetch;
+  }
+  // ---------------------------------------------------------------------------
+  // Request helpers
+  // ---------------------------------------------------------------------------
+  buildUrl(path, query) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (query) {
+      Object.entries(query).forEach(([key, value]) => {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      });
+    }
+    return url.toString();
+  }
+  async request(path, options = {}) {
+    const url = this.buildUrl(path, options.query);
+    const headers = new Headers({ "Content-Type": "application/json" });
+    if (options.headers) {
+      Object.entries(options.headers).forEach(([k, v]) => {
+        if (v !== void 0) headers.set(k, v);
+      });
+    }
+    const response = await this.fetchImpl(url, { ...options, headers });
+    if (response.ok) {
+      const contentType = response.headers.get("content-type") || "";
+      if (contentType.includes("application/json")) {
+        return await response.json();
+      }
+      return await response.text();
+    }
+    let body;
+    const text = await response.text();
+    try {
+      body = JSON.parse(text);
+    } catch {
+      body = text;
+    }
+    const message = body?.error && typeof body.error === "string" ? body.error : body?.message && typeof body.message === "string" ? body.message : `Request failed with status ${response.status}`;
+    throw new QueryError(message, "HTTP_ERROR", {
+      status: response.status,
+      body
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Query methods
+  // ---------------------------------------------------------------------------
+  /**
+   * Execute a path query against the knowledge graph.
+   *
+   * @param pathQuery - The path query string (e.g., '"alice austen" -[*]{,4}-> type:person')
+   * @param options - Query options (k, k_explore, lineage, enrich, etc.)
+   * @returns Query results with entities, paths, and metadata
+   *
+   * @example
+   * ```typescript
+   * // Simple semantic search
+   * const results = await query.path('"Washington" type:person');
+   *
+   * // Multi-hop traversal
+   * const results = await query.path('"alice austen" -[*]{,4}-> type:person ~ "photographer"');
+   *
+   * // With lineage filtering (collection scope)
+   * const results = await query.path('"letters" type:document', {
+   *   lineage: { sourcePi: 'arke:my_collection', direction: 'descendants' },
+   *   k: 10,
+   * });
+   * ```
+   */
+  async path(pathQuery, options = {}) {
+    return this.request("/query/path", {
+      method: "POST",
+      body: JSON.stringify({
+        path: pathQuery,
+        ...options
+      })
+    });
+  }
+  /**
+   * Execute a natural language query.
+   *
+   * The query is translated to a path query using an LLM, then executed.
+   *
+   * @param question - Natural language question
+   * @param options - Query options including custom_instructions for the LLM
+   * @returns Query results with translation info
+   *
+   * @example
+   * ```typescript
+   * const results = await query.natural('Find photographers connected to Alice Austen');
+   * console.log('Generated query:', results.translation.path);
+   * console.log('Explanation:', results.translation.explanation);
+   * ```
+   */
+  async natural(question, options = {}) {
+    const { custom_instructions, ...queryOptions } = options;
+    return this.request("/query/natural", {
+      method: "POST",
+      body: JSON.stringify({
+        query: question,
+        custom_instructions,
+        ...queryOptions
+      })
+    });
+  }
+  /**
+   * Translate a natural language question to a path query without executing it.
+   *
+   * Useful for understanding how questions are translated or for manual execution later.
+   *
+   * @param question - Natural language question
+   * @param customInstructions - Optional additional instructions for the LLM
+   * @returns Translation result with path query and explanation
+   *
+   * @example
+   * ```typescript
+   * const result = await query.translate('Who wrote letters from Philadelphia?');
+   * console.log('Path query:', result.path);
+   * // '"letters" <-[authored, wrote]- type:person -[located]-> "Philadelphia"'
+   * ```
+   */
+  async translate(question, customInstructions) {
+    return this.request("/query/translate", {
+      method: "POST",
+      body: JSON.stringify({
+        query: question,
+        custom_instructions: customInstructions
+      })
+    });
+  }
+  /**
+   * Parse and validate a path query without executing it.
+   *
+   * Returns the AST (Abstract Syntax Tree) if valid, or throws an error.
+   *
+   * @param pathQuery - The path query to parse
+   * @returns Parsed AST
+   * @throws QueryError if the query has syntax errors
+   *
+   * @example
+   * ```typescript
+   * try {
+   *   const result = await query.parse('"test" -[*]-> type:person');
+   *   console.log('Valid query, AST:', result.ast);
+   * } catch (err) {
+   *   console.error('Invalid query:', err.message);
+   * }
+   * ```
+   */
+  async parse(pathQuery) {
+    const url = this.buildUrl("/query/parse", { path: pathQuery });
+    const response = await this.fetchImpl(url, {
+      method: "GET",
+      headers: { "Content-Type": "application/json" }
+    });
+    const body = await response.json();
+    if ("error" in body && body.error === "Parse error") {
+      throw new QueryError(
+        body.message,
+        "PARSE_ERROR",
+        { position: body.position }
+      );
+    }
+    if (!response.ok) {
+      throw new QueryError(
+        body.error || `Request failed with status ${response.status}`,
+        "HTTP_ERROR",
+        { status: response.status, body }
+      );
+    }
+    return body;
+  }
+  /**
+   * Get the path query syntax documentation.
+   *
+   * Returns comprehensive documentation including entry points, edge traversal,
+   * filters, examples, and constraints.
+   *
+   * @returns Syntax documentation
+   *
+   * @example
+   * ```typescript
+   * const syntax = await query.syntax();
+   *
+   * // List all entry point types
+   * syntax.entryPoints.types.forEach(ep => {
+   *   console.log(`${ep.syntax} - ${ep.description}`);
+   * });
+   *
+   * // Show examples
+   * syntax.examples.forEach(ex => {
+   *   console.log(`${ex.description}: ${ex.query}`);
+   * });
+   * ```
+   */
+  async syntax() {
+    return this.request("/query/syntax", {
+      method: "GET"
+    });
+  }
+  /**
+   * Check the health of the query service.
+   *
+   * @returns Health status
+   */
+  async health() {
+    return this.request("/query/health", { method: "GET" });
+  }
+  /**
+   * Direct semantic search against the vector index.
+   *
+   * This bypasses the path query syntax and directly queries Pinecone for
+   * semantically similar entities. Useful for:
+   * - Simple semantic searches without graph traversal
+   * - Scoped searches filtered by source_pi (collection scope)
+   * - Type-filtered semantic searches
+   *
+   * For graph traversal and path-based queries, use `path()` instead.
+   *
+   * @param text - Search query text
+   * @param options - Search options (namespace, filters, top_k)
+   * @returns Matching entities with similarity scores
+   *
+   * @example
+   * ```typescript
+   * // Simple semantic search
+   * const results = await query.semanticSearch('photographers from New York');
+   *
+   * // Scoped to a specific PI (collection)
+   * const scoped = await query.semanticSearch('portraits', {
+   *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },
+   *   top_k: 20,
+   * });
+   *
+   * // Filter by type
+   * const people = await query.semanticSearch('artists', {
+   *   filter: { type: 'person' },
+   * });
+   *
+   * // Search across merged entities from multiple source PIs
+   * const merged = await query.semanticSearch('historical documents', {
+   *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },
+   * });
+   * ```
+   */
+  async semanticSearch(text, options = {}) {
+    let pineconeFilter;
+    if (options.filter) {
+      pineconeFilter = {};
+      if (options.filter.type) {
+        const types = Array.isArray(options.filter.type) ? options.filter.type : [options.filter.type];
+        pineconeFilter.type = types.length === 1 ? { $eq: types[0] } : { $in: types };
+      }
+      if (options.filter.source_pi) {
+        const pis = Array.isArray(options.filter.source_pi) ? options.filter.source_pi : [options.filter.source_pi];
+        pineconeFilter.source_pi = pis.length === 1 ? { $eq: pis[0] } : { $in: pis };
+      }
+      if (options.filter.merged_entities_source_pis) {
+        const pis = Array.isArray(options.filter.merged_entities_source_pis) ? options.filter.merged_entities_source_pis : [options.filter.merged_entities_source_pis];
+        pineconeFilter.merged_entities_source_pis = { $in: pis };
+      }
+      if (Object.keys(pineconeFilter).length === 0) {
+        pineconeFilter = void 0;
+      }
+    }
+    return this.request("/query/search/semantic", {
+      method: "POST",
+      body: JSON.stringify({
+        text,
+        namespace: options.namespace,
+        filter: pineconeFilter,
+        top_k: options.top_k
+      })
+    });
+  }
+  /**
+   * Search for collections by semantic similarity.
+   *
+   * Searches the dedicated collections index for fast semantic matching.
+   *
+   * @param query - Search query text
+   * @param options - Search options (limit, visibility filter)
+   * @returns Matching collections with similarity scores
+   *
+   * @example
+   * ```typescript
+   * // Search for photography-related collections
+   * const results = await query.searchCollections('photography');
+   * console.log(results.collections[0].title);
+   *
+   * // Search only public collections
+   * const publicResults = await query.searchCollections('history', {
+   *   visibility: 'public',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async searchCollections(query, options = {}) {
+    return this.request("/query/search/collections", {
+      method: "GET",
+      query: {
+        q: query,
+        limit: options.limit?.toString(),
+        visibility: options.visibility
+      }
+    });
+  }
+};
+export {
+  QueryClient,
+  QueryError
+};
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/query/errors.ts","../../src/query/client.ts"],"sourcesContent":["/**\n * Error class for query operations\n */\nexport class QueryError extends Error {\n  constructor(\n    message: string,\n    public code: string = 'UNKNOWN_ERROR',\n    public details?: unknown\n  ) {\n    super(message);\n    this.name = 'QueryError';\n  }\n}\n","import { QueryError } from './errors';\nimport type {\n  PathQueryOptions,\n  NaturalQueryOptions,\n  QueryResult,\n  NaturalQueryResult,\n  TranslateResult,\n  ParseResult,\n  ParseError,\n  SyntaxDocumentation,\n  SemanticSearchOptions,\n  SemanticSearchResponse,\n  CollectionSearchOptions,\n  CollectionSearchResponse,\n} from './types';\n\n/**\n * Configuration for QueryClient\n */\nexport interface QueryClientConfig {\n  /**\n   * Gateway base URL (e.g., https://gateway.arke.institute).\n   * The client will call /query/* endpoints.\n   */\n  gatewayUrl: string;\n  /**\n   * Optional custom fetch implementation (useful for testing).\n   */\n  fetchImpl?: typeof fetch;\n}\n\ntype JsonBody = Record<string, unknown>;\n\n/**\n * Client for querying the Arke knowledge graph.\n *\n * All query endpoints are public and do not require authentication.\n *\n * @example\n * ```typescript\n * const query = new QueryClient({\n *   gatewayUrl: 'https://gateway.arke.institute',\n * });\n *\n * // Direct path query\n * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person');\n *\n * // Natural language query\n * const nlResults = await query.natural('Find photographers connected to Alice Austen');\n *\n * // Get syntax documentation\n * const syntax = await query.syntax();\n * ```\n */\nexport class QueryClient {\n  private baseUrl: string;\n  private fetchImpl: typeof fetch;\n\n  constructor(config: QueryClientConfig) {\n    this.baseUrl = config.gatewayUrl.replace(/\\/$/, '');\n    this.fetchImpl = config.fetchImpl ?? fetch;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Request helpers\n  // ---------------------------------------------------------------------------\n\n  private buildUrl(path: string, query?: Record<string, string | undefined>) {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (query) {\n      Object.entries(query).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      });\n    }\n    return url.toString();\n  }\n\n  private async request<T>(\n    path: string,\n    options: RequestInit & {\n      query?: Record<string, string | undefined>;\n    } = {}\n  ): Promise<T> {\n    const url = this.buildUrl(path, options.query);\n    const headers = new Headers({ 'Content-Type': 'application/json' });\n    if (options.headers) {\n      Object.entries(options.headers).forEach(([k, v]) => {\n        if (v !== undefined) headers.set(k, v as string);\n      });\n    }\n\n    const response = await this.fetchImpl(url, { ...options, headers });\n\n    if (response.ok) {\n      const contentType = response.headers.get('content-type') || '';\n      if (contentType.includes('application/json')) {\n        return (await response.json()) as T;\n      }\n      return (await response.text()) as unknown as T;\n    }\n\n    let body: unknown;\n    const text = await response.text();\n    try {\n      body = JSON.parse(text);\n    } catch {\n      body = text;\n    }\n\n    const message =\n      (body as JsonBody)?.error && typeof (body as JsonBody).error === 'string'\n        ? ((body as JsonBody).error as string)\n        : (body as JsonBody)?.message && typeof (body as JsonBody).message === 'string'\n          ? ((body as JsonBody).message as string)\n          : `Request failed with status ${response.status}`;\n\n    throw new QueryError(message, 'HTTP_ERROR', {\n      status: response.status,\n      body,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Query methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Execute a path query against the knowledge graph.\n   *\n   * @param pathQuery - The path query string (e.g., '\"alice austen\" -[*]{,4}-> type:person')\n   * @param options - Query options (k, k_explore, lineage, enrich, etc.)\n   * @returns Query results with entities, paths, and metadata\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.path('\"Washington\" type:person');\n   *\n   * // Multi-hop traversal\n   * const results = await query.path('\"alice austen\" -[*]{,4}-> type:person ~ \"photographer\"');\n   *\n   * // With lineage filtering (collection scope)\n   * const results = await query.path('\"letters\" type:document', {\n   *   lineage: { sourcePi: 'arke:my_collection', direction: 'descendants' },\n   *   k: 10,\n   * });\n   * ```\n   */\n  async path(pathQuery: string, options: PathQueryOptions = {}): Promise<QueryResult> {\n    return this.request<QueryResult>('/query/path', {\n      method: 'POST',\n      body: JSON.stringify({\n        path: pathQuery,\n        ...options,\n      }),\n    });\n  }\n\n  /**\n   * Execute a natural language query.\n   *\n   * The query is translated to a path query using an LLM, then executed.\n   *\n   * @param question - Natural language question\n   * @param options - Query options including custom_instructions for the LLM\n   * @returns Query results with translation info\n   *\n   * @example\n   * ```typescript\n   * const results = await query.natural('Find photographers connected to Alice Austen');\n   * console.log('Generated query:', results.translation.path);\n   * console.log('Explanation:', results.translation.explanation);\n   * ```\n   */\n  async natural(question: string, options: NaturalQueryOptions = {}): Promise<NaturalQueryResult> {\n    const { custom_instructions, ...queryOptions } = options;\n    return this.request<NaturalQueryResult>('/query/natural', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions,\n        ...queryOptions,\n      }),\n    });\n  }\n\n  /**\n   * Translate a natural language question to a path query without executing it.\n   *\n   * Useful for understanding how questions are translated or for manual execution later.\n   *\n   * @param question - Natural language question\n   * @param customInstructions - Optional additional instructions for the LLM\n   * @returns Translation result with path query and explanation\n   *\n   * @example\n   * ```typescript\n   * const result = await query.translate('Who wrote letters from Philadelphia?');\n   * console.log('Path query:', result.path);\n   * // '\"letters\" <-[authored, wrote]- type:person -[located]-> \"Philadelphia\"'\n   * ```\n   */\n  async translate(question: string, customInstructions?: string): Promise<TranslateResult> {\n    return this.request<TranslateResult>('/query/translate', {\n      method: 'POST',\n      body: JSON.stringify({\n        query: question,\n        custom_instructions: customInstructions,\n      }),\n    });\n  }\n\n  /**\n   * Parse and validate a path query without executing it.\n   *\n   * Returns the AST (Abstract Syntax Tree) if valid, or throws an error.\n   *\n   * @param pathQuery - The path query to parse\n   * @returns Parsed AST\n   * @throws QueryError if the query has syntax errors\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   const result = await query.parse('\"test\" -[*]-> type:person');\n   *   console.log('Valid query, AST:', result.ast);\n   * } catch (err) {\n   *   console.error('Invalid query:', err.message);\n   * }\n   * ```\n   */\n  async parse(pathQuery: string): Promise<ParseResult> {\n    const url = this.buildUrl('/query/parse', { path: pathQuery });\n    const response = await this.fetchImpl(url, {\n      method: 'GET',\n      headers: { 'Content-Type': 'application/json' },\n    });\n\n    const body = await response.json() as ParseResult | ParseError;\n\n    // Check if it's an error response (parse errors return 400)\n    if ('error' in body && body.error === 'Parse error') {\n      throw new QueryError(\n        (body as ParseError).message,\n        'PARSE_ERROR',\n        { position: (body as ParseError).position }\n      );\n    }\n\n    if (!response.ok) {\n      throw new QueryError(\n        (body as any).error || `Request failed with status ${response.status}`,\n        'HTTP_ERROR',\n        { status: response.status, body }\n      );\n    }\n\n    return body as ParseResult;\n  }\n\n  /**\n   * Get the path query syntax documentation.\n   *\n   * Returns comprehensive documentation including entry points, edge traversal,\n   * filters, examples, and constraints.\n   *\n   * @returns Syntax documentation\n   *\n   * @example\n   * ```typescript\n   * const syntax = await query.syntax();\n   *\n   * // List all entry point types\n   * syntax.entryPoints.types.forEach(ep => {\n   *   console.log(`${ep.syntax} - ${ep.description}`);\n   * });\n   *\n   * // Show examples\n   * syntax.examples.forEach(ex => {\n   *   console.log(`${ex.description}: ${ex.query}`);\n   * });\n   * ```\n   */\n  async syntax(): Promise<SyntaxDocumentation> {\n    return this.request<SyntaxDocumentation>('/query/syntax', {\n      method: 'GET',\n    });\n  }\n\n  /**\n   * Check the health of the query service.\n   *\n   * @returns Health status\n   */\n  async health(): Promise<{ status: string; service: string; version: string }> {\n    return this.request('/query/health', { method: 'GET' });\n  }\n\n  /**\n   * Direct semantic search against the vector index.\n   *\n   * This bypasses the path query syntax and directly queries Pinecone for\n   * semantically similar entities. Useful for:\n   * - Simple semantic searches without graph traversal\n   * - Scoped searches filtered by source_pi (collection scope)\n   * - Type-filtered semantic searches\n   *\n   * For graph traversal and path-based queries, use `path()` instead.\n   *\n   * @param text - Search query text\n   * @param options - Search options (namespace, filters, top_k)\n   * @returns Matching entities with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Simple semantic search\n   * const results = await query.semanticSearch('photographers from New York');\n   *\n   * // Scoped to a specific PI (collection)\n   * const scoped = await query.semanticSearch('portraits', {\n   *   filter: { source_pi: '01K75HQQXNTDG7BBP7PS9AWYAN' },\n   *   top_k: 20,\n   * });\n   *\n   * // Filter by type\n   * const people = await query.semanticSearch('artists', {\n   *   filter: { type: 'person' },\n   * });\n   *\n   * // Search across merged entities from multiple source PIs\n   * const merged = await query.semanticSearch('historical documents', {\n   *   filter: { merged_entities_source_pis: ['pi-1', 'pi-2'] },\n   * });\n   * ```\n   */\n  async semanticSearch(\n    text: string,\n    options: SemanticSearchOptions = {}\n  ): Promise<SemanticSearchResponse> {\n    // Build Pinecone-compatible filter from our typed filter\n    let pineconeFilter: Record<string, unknown> | undefined;\n\n    if (options.filter) {\n      pineconeFilter = {};\n\n      if (options.filter.type) {\n        const types = Array.isArray(options.filter.type)\n          ? options.filter.type\n          : [options.filter.type];\n        pineconeFilter.type = types.length === 1\n          ? { $eq: types[0] }\n          : { $in: types };\n      }\n\n      if (options.filter.source_pi) {\n        const pis = Array.isArray(options.filter.source_pi)\n          ? options.filter.source_pi\n          : [options.filter.source_pi];\n        pineconeFilter.source_pi = pis.length === 1\n          ? { $eq: pis[0] }\n          : { $in: pis };\n      }\n\n      if (options.filter.merged_entities_source_pis) {\n        const pis = Array.isArray(options.filter.merged_entities_source_pis)\n          ? options.filter.merged_entities_source_pis\n          : [options.filter.merged_entities_source_pis];\n        // Use $in for array field matching (any of the provided PIs)\n        pineconeFilter.merged_entities_source_pis = { $in: pis };\n      }\n\n      // If no filters were actually set, clear the object\n      if (Object.keys(pineconeFilter).length === 0) {\n        pineconeFilter = undefined;\n      }\n    }\n\n    return this.request<SemanticSearchResponse>('/query/search/semantic', {\n      method: 'POST',\n      body: JSON.stringify({\n        text,\n        namespace: options.namespace,\n        filter: pineconeFilter,\n        top_k: options.top_k,\n      }),\n    });\n  }\n\n  /**\n   * Search for collections by semantic similarity.\n   *\n   * Searches the dedicated collections index for fast semantic matching.\n   *\n   * @param query - Search query text\n   * @param options - Search options (limit, visibility filter)\n   * @returns Matching collections with similarity scores\n   *\n   * @example\n   * ```typescript\n   * // Search for photography-related collections\n   * const results = await query.searchCollections('photography');\n   * console.log(results.collections[0].title);\n   *\n   * // Search only public collections\n   * const publicResults = await query.searchCollections('history', {\n   *   visibility: 'public',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async searchCollections(\n    query: string,\n    options: CollectionSearchOptions = {}\n  ): Promise<CollectionSearchResponse> {\n    return this.request<CollectionSearchResponse>('/query/search/collections', {\n      method: 'GET',\n      query: {\n        q: query,\n        limit: options.limit?.toString(),\n        visibility: options.visibility,\n      },\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/upload/index.cjs

@@ -1502,7 +1502,6 @@ var CollectionsClient = class {
 };
 
 // src/upload/client.ts
-init_errors();
 function getUserIdFromToken(token) {
   try {
     const parts = token.split(".");
@@ -1587,22 +1586,12 @@ var UploadClient = class {
    *
    * Requires owner or editor role on the collection containing the parent PI.
    * Use this to add a folder or files to an existing collection hierarchy.
+   *
+   * Note: Permission checks are enforced server-side by the ingest worker.
+   * The server will return 403 if the user lacks edit access to the parent PI.
    */
   async addToCollection(options) {
     const { files, parentPi, customPrompts, processing, onProgress, dryRun } = options;
-    if (!dryRun) {
-      const permissions = await this.collectionsClient.getPiPermissions(parentPi);
-      if (!permissions.canEdit) {
-        if (!permissions.collection) {
-          throw new ValidationError(
-            `Cannot add files: PI "${parentPi}" is not part of any collection`
-          );
-        }
-        throw new ValidationError(
-          `Cannot add files to collection "${permissions.collection.title}": you need editor or owner role (current role: ${permissions.collection.role || "none"})`
-        );
-      }
-    }
     const uploader = new ArkeUploader({
       gatewayUrl: this.config.gatewayUrl,
       authToken: this.config.authToken,