Class DaluxBuildProvider

constructor

• new DaluxBuildProvider(): DaluxBuildProvider

  Returns DaluxBuildProvider

Readonlymanifest

download

• download(
      ctx: PluginContext,
      ref: SourceFileRef,
      options?: DownloadOptions,
  ): Promise<ArrayBuffer>

  Download file content.

  Parameters

  • ctx: PluginContext
  • ref: SourceFileRef
  • Optionaloptions: DownloadOptions

  Returns Promise<ArrayBuffer>

listContainers

• listContainers(
      ctx: PluginContext,
      projectId: string,
      parentId?: string,
      options?: ListOptions,
  ): Promise<Page<SourceContainer>>

  List containers within a project. parentId omitted means top level.

  The shape of the result is governed by capabilities.containerListing: direct-children returns only immediate children, flat-subtree returns the whole descendant set flattened with parentId links intact.

  Parameters

  • ctx: PluginContext
  • projectId: string
  • OptionalparentId: string
  • Optionaloptions: ListOptions

  Returns Promise<Page<SourceContainer>>

listFiles

• listFiles(
      ctx: PluginContext,
      projectId: string,
      containerId: string,
      filter?: FileFilter,
      options?: ListOptions,
  ): Promise<Page<SourceFile>>

  List files in a container. Whether descendants are included is governed by capabilities.listFilesIsRecursive.

  Parameters

  • ctx: PluginContext
  • projectId: string
  • containerId: string
  • Optionalfilter: FileFilter
  • Optionaloptions: ListOptions

  Returns Promise<Page<SourceFile>>

listProjects

• listProjects(
      ctx: PluginContext,
      options?: ListProjectsOptions,
  ): Promise<Page<SourceProject>>

  List projects visible to the authenticated identity.

  Providers reporting projectsAreDiscoverableOnly may return a partial or empty page when query is absent; the host then prompts the user to search or paste a URL rather than presenting the result as complete.

  Parameters

  • ctx: PluginContext
  • Optionaloptions: ListProjectsOptions

  Returns Promise<Page<SourceProject>>

testConnection

• testConnection(ctx: PluginContext): Promise<ConnectionTestResult>

  Optional: test the connection and return a diagnostic message.

  Parameters

  • ctx: PluginContext

  Returns Promise<ConnectionTestResult>

watchRevisions

• watchRevisions(
      ctx: PluginContext,
      refs: readonly SourceFileRef[],
      _cursor?: string,
      options?: ListOptions,
  ): Promise<RevisionWatchResult>

  Dalux has no delta/change-feed endpoint, so watching means polling the given refs. Grouped strictly by file area so a sweep covering many refs from the same area issues one listing sweep total — never a project- or account-wide crawl, and never more than one sweep per distinct area.

  Two failure-isolation rules, both load-bearing:

  1. One area's sweep failing (a deleted file area 404ing, or a pagination error) must not abort the whole call — that would discard the already-detected events from every other, healthy area too. So each area's sweep is caught individually and warned about rather than the call rejecting outright. Only a definitive not-found (HTTP 404) turns into deleted: true events; any other failure leaves that area's refs without an event this poll, because "the request failed" is not evidence that "the file is gone upstream".
  2. ctx.storage.set/delete for every area are buffered and only committed once the whole sweep is done, never per-area as each area finishes. Advancing a cache immediately and then discovering a later area failed used to mean: if the host reacted to that failure by discarding this call's events, the already-advanced caches would make the next poll compare against the new value and never emit the now-lost event again — permanently. Buffering means a cache is only ever advanced past a change once that change's event has actually been returned.

  Parameters

  • ctx: PluginContext
  • refs: readonly SourceFileRef[]
  • Optional_cursor: string
  • Optionaloptions: ListOptions

  Returns Promise<RevisionWatchResult>