@milaboratories/pl-model-common 1.39.0 → 1.40.0

package/dist/drivers/ls.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ls.cjs","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n\n  // TODO\n  // pathStartsWithDisk\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,cAAA,YAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}
+{"version":3,"file":"ls.cjs","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  /** Stable machine identifier (e.g. \"library\", \"root\", \"local\"). Used for filtering. */\n  id: string;\n  /** Human-readable display name. */\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,cAAA,YAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}

package/dist/drivers/ls.d.ts

@@ -14,6 +14,7 @@ type StorageHandleLocal = `local://${string}`;
 type StorageHandleRemote = `remote://${string}`;
 type StorageHandle = StorageHandleLocal | StorageHandleRemote;
 type StorageEntry = {
+  /** Stable machine identifier (e.g. "library", "root", "local"). Used for filtering. */id: string; /** Human-readable display name. */
   name: string;
   handle: StorageHandle;
   initialFullPath: string;

package/dist/drivers/ls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ls.d.ts","names":[],"sources":["../../src/drivers/ls.ts"],"mappings":";;;;KAQY,sBAAA;AAAA,KACA,qBAAA;AAAA,KAEA,gBAAA,GAAmB,sBAAA,GAAyB,qBAAA;AAAA,KAE5C,qBAAA,GAAwB,OAAA,CAAQ,gBAAA;AAAA,iBAE5B,wBAAA,CACd,MAAA,EAAQ,gBAAA,GACP,MAAA,IAAU,sBAAA;AAAA,iBAIG,uBAAA,CAAwB,MAAA,EAAQ,gBAAA,GAAmB,MAAA,IAAU,qBAAA;;KAKjE,kBAAA;AAjBZ;AAAA,KAoBY,mBAAA;AAAA,KAEA,aAAA,GAAgB,kBAAA,GAAqB,mBAAA;AAAA,KAErC,YAAA;EACV,IAAA;EACA,MAAA,EAAQ,aAAA;EACR,eAAA;AAAA;AAAA,KAMU,eAAA;EACV,MAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,KAGC,OAAA;EAEN,IAAA;EACA,IAAA;EACA,QAAA;AAAA;EAGA,IAAA;EACA,IAAA;EACA,QAAA,UAxCJ;EA2CI,MAAA,EAAQ,gBAAA;AAAA;AAAA,KAGF,gBAAA;EA7CuB,6CA+CxB,IAAA,UA3C4B;EAAA,SA6C5B,UAAA;AAAA;AAAA,KAGC,aAAA;EAhD4B,wCAkD7B,KAAA,WAlDkE;EAAA,SAoDlE,WAAA,WApDuF;EAAA,SAsDvF,OAAA,GAAU,gBAAA;AAAA;AAAA,KAGT,sBAAA;EApDkB;;EAAA,SAuDnB,IAAA,GAAO,qBAAA;AAAA;AAAA,KAGN,yBAAA;EAvDmB;;EAAA,SA0DpB,KAAA,GAAQ,qBAAA;AAAA;;KAIP,SAAA;EA5DwD,2CA8DzD,IAAA,UA5Da;EAAA,SA8Db,EAAA;AAAA;AAAA,UAGM,QAAA;EA/Df;EAiEA,cAAA,IAAkB,OAAA,CAAQ,YAAA;EAE1B,SAAA,CAAU,OAAA,EAAS,aAAA,EAAe,QAAA,WAAmB,OAAA,CAAQ,eAAA;EAlE9C;EAqEf,wBAAA,CAAyB,GAAA,EAAK,aAAA,GAAgB,OAAA,CAAQ,sBAAA;EA/D5C;EAkEV,2BAAA,CAA4B,GAAA,EAAK,aAAA,GAAgB,OAAA,CAAQ,yBAAA;;EAGzD,gBAAA,CAAiB,IAAA,EAAM,qBAAA,GAAwB,OAAA;EApE/C;EAuEA,mBAAA,CAAoB,IAAA,EAAM,qBAAA,EAAuB,KAAA,GAAQ,UAAA,GAAa,OAAA,CAAQ,UAAA;EAtErE;;;AAGX;;;EA2EE,kBAAA,CAAmB,IAAA,EAAM,QAAA,GAAW,OAAA,CAAQ,gBAAA;EAzExC;EA4EJ,WAAA,KAAgB,OAAA;AAAA;;iBAIF,qBAAA,CAAsB,MAAA,EAAQ,gBAAA;;iBAmB9B,qBAAA,CAAsB,MAAA,EAAQ,gBAAA"}
+{"version":3,"file":"ls.d.ts","names":[],"sources":["../../src/drivers/ls.ts"],"mappings":";;;;KAQY,sBAAA;AAAA,KACA,qBAAA;AAAA,KAEA,gBAAA,GAAmB,sBAAA,GAAyB,qBAAA;AAAA,KAE5C,qBAAA,GAAwB,OAAA,CAAQ,gBAAA;AAAA,iBAE5B,wBAAA,CACd,MAAA,EAAQ,gBAAA,GACP,MAAA,IAAU,sBAAA;AAAA,iBAIG,uBAAA,CAAwB,MAAA,EAAQ,gBAAA,GAAmB,MAAA,IAAU,qBAAA;;KAKjE,kBAAA;AAjBZ;AAAA,KAoBY,mBAAA;AAAA,KAEA,aAAA,GAAgB,kBAAA,GAAqB,mBAAA;AAAA,KAErC,YAAA;EAxBqB,uFA0B/B,EAAA,UAxB0B;EA0B1B,IAAA;EACA,MAAA,EAAQ,aAAA;EACR,eAAA;AAAA;AAAA,KAGU,eAAA;EACV,MAAA;EACA,OAAA,EAAS,OAAA;AAAA;AAAA,KAGC,OAAA;EAEN,IAAA;EACA,IAAA;EACA,QAAA;AAAA;EAGA,IAAA;EACA,IAAA;EACA,QAAA,UAvC6B;EA0C7B,MAAA,EAAQ,gBAAA;AAAA;AAAA,KAGF,gBAAA;+CAED,IAAA,UA3CqC;EAAA,SA6CrC,UAAA;AAAA;AAAA,KAGC,aAAA;EAhDsF,wCAkDvF,KAAA,WA7CC;EAAA,SA+CD,WAAA;WAEA,OAAA,GAAU,gBAAA;AAAA;AAAA,KAGT,sBAAA;EAjDmB;;EAAA,SAoDpB,IAAA,GAAO,qBAAA;AAAA;AAAA,KAGN,yBAAA;EArDa;;EAAA,SAwDd,KAAA,GAAQ,qBAAA;AAAA;AAtDnB;AAAA,KA0DY,SAAA;6CAED,IAAA,UA1DT;EAAA,SA4DS,EAAA;AAAA;AAAA,UAGM,QAAA;EA3Df;EA6DA,cAAA,IAAkB,OAAA,CAAQ,YAAA;EAE1B,SAAA,CAAU,OAAA,EAAS,aAAA,EAAe,QAAA,WAAmB,OAAA,CAAQ,eAAA;EA5DnD;EA+DV,wBAAA,CAAyB,GAAA,EAAK,aAAA,GAAgB,OAAA,CAAQ,sBAAA;;EAGtD,2BAAA,CAA4B,GAAA,EAAK,aAAA,GAAgB,OAAA,CAAQ,yBAAA;EAjEzD;EAoEA,gBAAA,CAAiB,IAAA,EAAM,qBAAA,GAAwB,OAAA;EAnEtC;EAsET,mBAAA,CAAoB,IAAA,EAAM,qBAAA,EAAuB,KAAA,GAAQ,UAAA,GAAa,OAAA,CAAQ,UAAA;EAtE9D;AAGlB;;;;;EA2EE,kBAAA,CAAmB,IAAA,EAAM,QAAA,GAAW,OAAA,CAAQ,gBAAA;EAvExC;EA0EJ,WAAA,KAAgB,OAAA;AAAA;;iBAIF,qBAAA,CAAsB,MAAA,EAAQ,gBAAA;;iBAmB9B,qBAAA,CAAsB,MAAA,EAAQ,gBAAA"}

package/dist/drivers/ls.js.map

@@ -1 +1 @@
-{"version":3,"file":"ls.js","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n\n  // TODO\n  // pathStartsWithDisk\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,aAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}
+{"version":3,"file":"ls.js","names":[],"sources":["../../src/drivers/ls.ts"],"sourcesContent":["import { assertNever } from \"../util\";\nimport type { Branded } from \"../branding\";\nimport type { TableRange } from \"./pframe\";\nimport type { FileLike } from \"./interfaces\";\n\nconst uploadPrefix = \"upload://upload/\";\nconst indexPrefix = \"index://index/\";\n\nexport type ImportFileHandleUpload = `upload://upload/${string}`;\nexport type ImportFileHandleIndex = `index://index/${string}`;\n\nexport type ImportFileHandle = ImportFileHandleUpload | ImportFileHandleIndex;\n\nexport type LocalImportFileHandle = Branded<ImportFileHandle, \"Local\">;\n\nexport function isImportFileHandleUpload(\n  handle: ImportFileHandle,\n): handle is ImportFileHandleUpload {\n  return handle.startsWith(uploadPrefix);\n}\n\nexport function isImportFileHandleIndex(handle: ImportFileHandle): handle is ImportFileHandleIndex {\n  return handle.startsWith(indexPrefix);\n}\n\n/** Results in upload */\nexport type StorageHandleLocal = `local://${string}`;\n\n/** Results in index */\nexport type StorageHandleRemote = `remote://${string}`;\n\nexport type StorageHandle = StorageHandleLocal | StorageHandleRemote;\n\nexport type StorageEntry = {\n  /** Stable machine identifier (e.g. \"library\", \"root\", \"local\"). Used for filtering. */\n  id: string;\n  /** Human-readable display name. */\n  name: string;\n  handle: StorageHandle;\n  initialFullPath: string;\n};\n\nexport type ListFilesResult = {\n  parent?: string;\n  entries: LsEntry[];\n};\n\nexport type LsEntry =\n  | {\n      type: \"dir\";\n      name: string;\n      fullPath: string;\n    }\n  | {\n      type: \"file\";\n      name: string;\n      fullPath: string;\n\n      /** This handle should be set to args... */\n      handle: ImportFileHandle;\n    };\n\nexport type OpenDialogFilter = {\n  /** Human-readable file type name */\n  readonly name: string;\n  /** File extensions */\n  readonly extensions: string[];\n};\n\nexport type OpenDialogOps = {\n  /** Open dialog window title */\n  readonly title?: string;\n  /** Custom label for the confirmation button, when left empty the default label will be used. */\n  readonly buttonLabel?: string;\n  /** Limits of file types user can select */\n  readonly filters?: OpenDialogFilter[];\n};\n\nexport type OpenSingleFileResponse = {\n  /** Contains local file handle, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly file?: LocalImportFileHandle;\n};\n\nexport type OpenMultipleFilesResponse = {\n  /** Contains local file handles, allowing file importing or content reading. If user canceled\n   * the dialog, field will be undefined. */\n  readonly files?: LocalImportFileHandle[];\n};\n\n/** Can be used to limit request for local file content to a certain bytes range */\nexport type FileRange = {\n  /** From byte index (inclusive) */\n  readonly from: number;\n  /** To byte index (exclusive) */\n  readonly to: number;\n};\n\nexport interface LsDriver {\n  /** remote and local storages */\n  getStorageList(): Promise<StorageEntry[]>;\n\n  listFiles(storage: StorageHandle, fullPath: string): Promise<ListFilesResult>;\n\n  /** Opens system file open dialog allowing to select single file and awaits user action */\n  showOpenSingleFileDialog(ops: OpenDialogOps): Promise<OpenSingleFileResponse>;\n\n  /** Opens system file open dialog allowing to multiple files and awaits user action */\n  showOpenMultipleFilesDialog(ops: OpenDialogOps): Promise<OpenMultipleFilesResponse>;\n\n  /** Given a handle to a local file, allows to get file size */\n  getLocalFileSize(file: LocalImportFileHandle): Promise<number>;\n\n  /** Given a handle to a local file, allows to get its content */\n  getLocalFileContent(file: LocalImportFileHandle, range?: TableRange): Promise<Uint8Array>;\n\n  /**\n   * Resolves browser's File object into platforma's import file handle.\n   *\n   * This method is useful among other things for implementation of UI\n   * components, that handle file Drag&Drop.\n   * */\n  fileToImportHandle(file: FileLike): Promise<ImportFileHandle>;\n\n  /** Saves currently opened block webview as a PDF. */\n  exportToPdf?(): Promise<void>;\n}\n\n/** Gets a file path from an import handle. */\nexport function getFilePathFromHandle(handle: ImportFileHandle): string {\n  if (isImportFileHandleIndex(handle)) {\n    const trimmed = handle.slice(indexPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { path: string };\n    return data.path;\n  } else if (isImportFileHandleUpload(handle)) {\n    const trimmed = handle.slice(uploadPrefix.length);\n    const data = JSON.parse(decodeURIComponent(trimmed)) as { localPath: string };\n    return data.localPath;\n  }\n\n  assertNever(handle);\n}\n\nfunction extractFileName(filePath: string) {\n  return filePath.replace(/^.*[\\\\/]/, \"\");\n}\n\n/** Gets a file name from an import handle. */\nexport function getFileNameFromHandle(handle: ImportFileHandle): string {\n  return extractFileName(getFilePathFromHandle(handle));\n}\n"],"mappings":";;AAKA,MAAM,eAAe;AACrB,MAAM,cAAc;AASpB,SAAgB,yBACd,QACkC;AAClC,QAAO,OAAO,WAAW,aAAa;;AAGxC,SAAgB,wBAAwB,QAA2D;AACjG,QAAO,OAAO,WAAW,YAAY;;;AA2GvC,SAAgB,sBAAsB,QAAkC;AACtE,KAAI,wBAAwB,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,MAAM,GAAmB;AAEhD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;YACH,yBAAyB,OAAO,EAAE;EAC3C,MAAM,UAAU,OAAO,MAAM,GAAoB;AAEjD,SADa,KAAK,MAAM,mBAAmB,QAAQ,CAAC,CACxC;;AAGd,aAAY,OAAO;;AAGrB,SAAS,gBAAgB,UAAkB;AACzC,QAAO,SAAS,QAAQ,YAAY,GAAG;;;AAIzC,SAAgB,sBAAsB,QAAkC;AACtE,QAAO,gBAAgB,sBAAsB,OAAO,CAAC"}

package/dist/index.d.ts

@@ -63,4 +63,5 @@ import { Base64Compatible, Base64Encoded, base64Decode, base64Encode } from "./b
 import { assertNever, uniqueBy } from "./util.js";
 import { BasicHttpAuth, HttpAuth, parseHttpAuth, serializeHttpAuth } from "./httpAuth.js";
 import { ResourceTypeName, ResourceTypePrefix } from "./resource_types.js";
-export { AAxisSelector, ADomain, AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyFunction, AnyLogHandle, ArchiveFormat, ArrayTypeUnion, ArtificialColumnJoinEntry, Assert, AssertKeysEqual, AuthorMarker, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, Base64Compatible, Base64Encoded, BasicHttpAuth, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags, BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockOutputsBase, BlockRenderingMode, BlockSection, BlockSectionDelimiter, BlockSectionLink, BlockSectionLinkAppearance, BlockState, BlockStateV3, BlockUIURL, Branded, BuildQueryInput, CalculateTableDataRequest, CalculateTableDataResponse, CanonicalizedJson, ChunkedStreamReader, ChunkedStreamReaderOptions, Code, ColumnAxesWithQualifications, ColumnFilter, ColumnJoinEntry, ColumnValueType, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, CreateEnrichmentRefOptions, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DatasetInput, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, DriverKit, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, ErrorHandlerStatus, EvaluateQueryResponse, FileFilter, FileLike, FileRange, FilterKeysByPrefix, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, HttpAuth, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, IncompatibleFlagsError, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InferServiceKind, InferServiceModel, InferServiceUi, InlineColumnJoinEntry, InnerJoin, Is, IsSubtypeOf, JoinEntry, JsonCompatible, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, JsonSerializable, KnownServiceName, LabeledEnrichmentRef, LabeledEnrichmentRefs, LegacyAxisSelector, LinkerMap, ListFilesResult, ListOptionBase, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LogsDriver, LsDriver, LsEntry, MODEL_SERVICE_METHOD_MAP, MatcherMap, Metadata, MetadataJson, ModelServiceFactoryMap, ModelServiceRegistry, ModelServices, MultiAxisSelector, MultiColumnSelector, NativePObjectId, NavigationState, NodeServiceHandlerMap, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, Option, OuterJoin, OutputWithStatus, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnInfo, PColumnKey, PColumnLazy, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameDriverError, PFrameError, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PFrameSpecDriverError, PObject, PObjectId, PObjectSpec, PSpecPredicate, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntry, PoolEntryGuard, PrimaryRef, ProgressLogWithInfo, REQUIRES_PFRAMES_VERSION, RangeBytes, ReadyLogHandle, Ref, RemoteBlobHandle, RemoteBlobHandleAndSize, RequireServices, ResolveAnchorsOptions, ResourceTypeName, ResourceTypePrefix, ResultCollection, ResultOrError, ResultPoolEntry, RootFilterSpec, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, SUniversalPColumnId, SerializedError, ServiceAlreadyRegisteredError, ServiceBrand, ServiceDispatch, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceName, ServiceNameLiterals, ServiceNotRegisteredError, ServiceRequireFlags, ServiceType, ServiceTypesLike, Services, ShowSaveDialogOptions, ShowSaveDialogResult, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, StringifiedJson, SupportedRequirement, TableRange, Trace, TraceEntry, UiError, UiServiceFactoryMap, UiServiceRegistry, UiServices, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, ValueOrError, ValueType, ValueTypeSupported, ValueWithUTag, ValueWithUTagAndAuthor, WritePTableToFsOptions, WritePTableToFsResult, assertNever, base64Decode, base64Encode, bigintReplacer, buildServiceInfo, canonicalizeAxisId, canonicalizeAxisWithParents, canonicalizeJson, checkBlockFlag, collectSpecQueryColumns, createDiscoveredPColumn, createDiscoveredPColumnId, createEnrichmentRef, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, ensureError, ensurePColumn, entriesToDataInfo, executePSpecPredicate, extractAllColumns, extractAllRequirements, extractAllSupports, extractCodeWithInfo, extractConfigGeneric, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getMethodNames, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getServiceKind, getServiceModelMethods, getServiceUiMethods, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, hasAbortError, isAbortError, isAggregateError, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isDataInfo, isDataInfoEntries, isDiscoveredPColumn, isEnrichmentRef, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isKnownServiceName, isLabelColumn, isLinkerColumn, isLiveLog, isMainService, isNodeService, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, isPFrameDriverError, isPFrameError, isPFrameSpecDriverError, isPTableNA, isPartitionedDataInfoEntries, isPlRef, isPrimaryRef, isServiceAlreadyRegisteredError, isServiceError, isServiceInjectionError, isServiceInvalidIdError, isServiceMethodNotFoundError, isServiceNotRegisteredError, isValueNA, isWasmService, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPObjectData, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, mapValueInVOE, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnId, parseDiscoveredPColumnId, parseHttpAuth, parseJson, plId, plRefsEqual, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, registerServiceCapabilities, resolveAnchors, resolveAnnotationParents, resolveNodeServiceHandler, resolveRequiredServices, serializeError, serializeHttpAuth, serializeResult, service, serviceFnKey, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnId, stringifyDiscoveredPColumnId, stringifyJson, traverseQuerySpec, uniqueBy, uniquePlId, unwrapResult, validateRangeBytes, visitDataInfo, withEnrichments, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback };
+import { ProjectId } from "./project_id.js";
+export { AAxisSelector, ADomain, AbortError, AllRequiresFeatureFlags, AllSupportsFeatureFlags, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyFunction, AnyLogHandle, ArchiveFormat, ArrayTypeUnion, ArtificialColumnJoinEntry, Assert, AssertKeysEqual, AuthorMarker, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, Base64Compatible, Base64Encoded, BasicHttpAuth, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags, BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockOutputsBase, BlockRenderingMode, BlockSection, BlockSectionDelimiter, BlockSectionLink, BlockSectionLinkAppearance, BlockState, BlockStateV3, BlockUIURL, Branded, BuildQueryInput, CalculateTableDataRequest, CalculateTableDataResponse, CanonicalizedJson, ChunkedStreamReader, ChunkedStreamReaderOptions, Code, ColumnAxesWithQualifications, ColumnFilter, ColumnJoinEntry, ColumnValueType, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, CreateEnrichmentRefOptions, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DatasetInput, DefaultNavigationState, DeleteColumnRequest, DeleteColumnResponse, DialogService, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, DiscoveredPColumn, DiscoveredPColumnId, Domain, DomainJson, DriverKit, EnrichmentLinkerStep, EnrichmentRef, EnrichmentStep, ErrorHandlerStatus, EvaluateQueryResponse, FileFilter, FileLike, FileRange, FilterKeysByPrefix, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, HttpAuth, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, IncompatibleFlagsError, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InferServiceKind, InferServiceModel, InferServiceUi, InlineColumnJoinEntry, InnerJoin, Is, IsSubtypeOf, JoinEntry, JsonCompatible, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, JsonSerializable, KnownServiceName, LabeledEnrichmentRef, LabeledEnrichmentRefs, LegacyAxisSelector, LinkerMap, ListFilesResult, ListOptionBase, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LogsDriver, LsDriver, LsEntry, MODEL_SERVICE_METHOD_MAP, MatcherMap, Metadata, MetadataJson, ModelServiceFactoryMap, ModelServiceRegistry, ModelServices, MultiAxisSelector, MultiColumnSelector, NativePObjectId, NavigationState, NodeServiceHandlerMap, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, Option, OuterJoin, OutputWithStatus, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnInfo, PColumnKey, PColumnLazy, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameDriverError, PFrameError, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PFrameSpecDriverError, PObject, PObjectId, PObjectSpec, PSpecPredicate, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, PlId, PlIdBytes, PlIdLength, PlRef, PoolEntry, PoolEntryGuard, PrimaryRef, ProgressLogWithInfo, ProjectId, REQUIRES_PFRAMES_VERSION, RangeBytes, ReadyLogHandle, Ref, RemoteBlobHandle, RemoteBlobHandleAndSize, RequireServices, ResolveAnchorsOptions, ResourceTypeName, ResourceTypePrefix, ResultCollection, ResultOrError, ResultPoolEntry, RootFilterSpec, RuntimeCapabilities, SERVICE_CAPABILITY_FLAGS, SERVICE_FEATURE_FLAGS, SERVICE_METHOD_MAP, SUniversalPColumnId, SerializedError, ServiceAlreadyRegisteredError, ServiceBrand, ServiceDispatch, ServiceError, ServiceInjectionError, ServiceInvalidIdError, ServiceMethodNotFoundError, ServiceName, ServiceNameLiterals, ServiceNotRegisteredError, ServiceRequireFlags, ServiceType, ServiceTypesLike, Services, ShowSaveDialogOptions, ShowSaveDialogResult, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryLinkerJoinLinker, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySymmetricJoin, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, StringifiedJson, SupportedRequirement, TableRange, Trace, TraceEntry, UiError, UiServiceFactoryMap, UiServiceRegistry, UiServices, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, ValueOrError, ValueType, ValueTypeSupported, ValueWithUTag, ValueWithUTagAndAuthor, WritePTableToFsOptions, WritePTableToFsResult, assertNever, base64Decode, base64Encode, bigintReplacer, buildServiceInfo, canonicalizeAxisId, canonicalizeAxisWithParents, canonicalizeJson, checkBlockFlag, collectSpecQueryColumns, createDiscoveredPColumn, createDiscoveredPColumnId, createEnrichmentRef, createNodeServiceHandlers, createPlRef, createPrimaryRef, dataInfoToEntries, deriveNativeId, deserializeError, deserializeResult, digestPlId, ensureError, ensurePColumn, entriesToDataInfo, executePSpecPredicate, extractAllColumns, extractAllRequirements, extractAllSupports, extractCodeWithInfo, extractConfigGeneric, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getMethodNames, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getServiceKind, getServiceModelMethods, getServiceUiMethods, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, hasAbortError, isAbortError, isAggregateError, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isDataInfo, isDataInfoEntries, isDiscoveredPColumn, isEnrichmentRef, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isKnownServiceName, isLabelColumn, isLinkerColumn, isLiveLog, isMainService, isNodeService, isPColumn, isPColumnResult, isPColumnSpec, isPColumnSpecResult, isPFrameDriverError, isPFrameError, isPFrameSpecDriverError, isPTableNA, isPartitionedDataInfoEntries, isPlRef, isPrimaryRef, isServiceAlreadyRegisteredError, isServiceError, isServiceInjectionError, isServiceInvalidIdError, isServiceMethodNotFoundError, isServiceNotRegisteredError, isValueNA, isWasmService, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPObjectData, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, mapValueInVOE, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnId, parseDiscoveredPColumnId, parseHttpAuth, parseJson, plId, plRefsEqual, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, registerServiceCapabilities, resolveAnchors, resolveAnnotationParents, resolveNodeServiceHandler, resolveRequiredServices, serializeError, serializeHttpAuth, serializeResult, service, serviceFnKey, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnId, stringifyDiscoveredPColumnId, stringifyJson, traverseQuerySpec, uniqueBy, uniquePlId, unwrapResult, validateRangeBytes, visitDataInfo, withEnrichments, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback };

package/dist/project_id.d.ts

@@ -0,0 +1,15 @@
+import { Branded } from "./branding.js";
+
+//#region src/project_id.d.ts
+/**
+ * Opaque identifier for a project, safe to persist and reuse across sessions.
+ * Internally this is a string derived from resource ID without signature.
+ * Unlike SignedResourceId, this does not carry cryptographic signatures and can be
+ * safely persisted, serialized, and reused across ML sessions.
+ * Absence of signature guarantees this ID cannot be used in transactions 'as-is',
+ * requiring the caller to operate with special types and helpers.
+ */
+type ProjectId = Branded<string, "ProjectId">;
+//#endregion
+export { ProjectId };
+//# sourceMappingURL=project_id.d.ts.map

package/dist/project_id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_id.d.ts","names":[],"sources":["../src/project_id.ts"],"mappings":";;;;;AAUA;;;;;;KAAY,SAAA,GAAY,OAAA"}

package/dist/resource_types.cjs

@@ -33,6 +33,7 @@ const ResourceTypeName = {
 	Null: "Null",
 	Binary: "binary",
 	LSProvider: "LSProvider",
+	WorkingDirectory: "WorkingDirectory",
 	UserProject: "UserProject",
 	Projects: "Projects",
 	ClientRoot: "ClientRoot"
@@ -40,6 +41,9 @@ const ResourceTypeName = {
 /** Resource type name prefix constants. */
 const ResourceTypePrefix = {
 	Blob: "Blob/",
+	LS: "LS/",
+	WorkingDirectory: "WorkingDirectory/",
+	StorageSpaceAllocation: "StorageSpaceAllocation/",
 	BlobUpload: "BlobUpload/",
 	BlobIndex: "BlobIndex/",
 	PColumnData: "PColumnData/",

package/dist/resource_types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource_types.cjs","names":[],"sources":["../src/resource_types.ts"],"sourcesContent":["/** Well-known resource type names used across the platform. */\nexport const ResourceTypeName = {\n  StreamManager: \"StreamManager\",\n  StdMap: \"StdMap\",\n  StdMapSlash: \"std/map\",\n  EphStdMap: \"EphStdMap\",\n  PFrame: \"PFrame\",\n  ParquetChunk: \"ParquetChunk\",\n  BContext: \"BContext\",\n  BlockPackCustom: \"BlockPackCustom\",\n  BinaryMap: \"BinaryMap\",\n  BinaryValue: \"BinaryValue\",\n  BlobMap: \"BlobMap\",\n  BResolveSingle: \"BResolveSingle\",\n  BResolveSingleNoResult: \"BResolveSingleNoResult\",\n  BQueryResult: \"BQueryResult\",\n  TengoTemplate: \"TengoTemplate\",\n  TengoLib: \"TengoLib\",\n  SoftwareInfo: \"SoftwareInfo\",\n  Dummy: \"Dummy\",\n  JsonResourceError: \"json/resourceError\",\n  JsonObject: \"json/object\",\n  JsonGzObject: \"json-gz/object\",\n  JsonString: \"json/string\",\n  JsonArray: \"json/array\",\n  JsonNumber: \"json/number\",\n  BContextEnd: \"BContextEnd\",\n  FrontendFromUrl: \"Frontend/FromUrl\",\n  FrontendFromFolder: \"Frontend/FromFolder\",\n  BObjectSpec: \"BObjectSpec\",\n  Blob: \"Blob\",\n  Null: \"Null\",\n  Binary: \"binary\",\n  LSProvider: \"LSProvider\",\n  UserProject: \"UserProject\",\n  Projects: \"Projects\",\n  ClientRoot: \"ClientRoot\",\n} as const;\n\n/** Resource type name prefix constants. */\nexport const ResourceTypePrefix = {\n  Blob: \"Blob/\",\n  BlobUpload: \"BlobUpload/\",\n  BlobIndex: \"BlobIndex/\",\n  PColumnData: \"PColumnData/\",\n  StreamWorkdir: \"StreamWorkdir/\",\n} as const;\n"],"mappings":";;AACA,MAAa,mBAAmB;CAC9B,eAAe;CACf,QAAQ;CACR,aAAa;CACb,WAAW;CACX,QAAQ;CACR,cAAc;CACd,UAAU;CACV,iBAAiB;CACjB,WAAW;CACX,aAAa;CACb,SAAS;CACT,gBAAgB;CAChB,wBAAwB;CACxB,cAAc;CACd,eAAe;CACf,UAAU;CACV,cAAc;CACd,OAAO;CACP,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,aAAa;CACb,iBAAiB;CACjB,oBAAoB;CACpB,aAAa;CACb,MAAM;CACN,MAAM;CACN,QAAQ;CACR,YAAY;CACZ,aAAa;CACb,UAAU;CACV,YAAY;CACb;;AAGD,MAAa,qBAAqB;CAChC,MAAM;CACN,YAAY;CACZ,WAAW;CACX,aAAa;CACb,eAAe;CAChB"}
+{"version":3,"file":"resource_types.cjs","names":[],"sources":["../src/resource_types.ts"],"sourcesContent":["/** Well-known resource type names used across the platform. */\nexport const ResourceTypeName = {\n  StreamManager: \"StreamManager\",\n  StdMap: \"StdMap\",\n  StdMapSlash: \"std/map\",\n  EphStdMap: \"EphStdMap\",\n  PFrame: \"PFrame\",\n  ParquetChunk: \"ParquetChunk\",\n  BContext: \"BContext\",\n  BlockPackCustom: \"BlockPackCustom\",\n  BinaryMap: \"BinaryMap\",\n  BinaryValue: \"BinaryValue\",\n  BlobMap: \"BlobMap\",\n  BResolveSingle: \"BResolveSingle\",\n  BResolveSingleNoResult: \"BResolveSingleNoResult\",\n  BQueryResult: \"BQueryResult\",\n  TengoTemplate: \"TengoTemplate\",\n  TengoLib: \"TengoLib\",\n  SoftwareInfo: \"SoftwareInfo\",\n  Dummy: \"Dummy\",\n  JsonResourceError: \"json/resourceError\",\n  JsonObject: \"json/object\",\n  JsonGzObject: \"json-gz/object\",\n  JsonString: \"json/string\",\n  JsonArray: \"json/array\",\n  JsonNumber: \"json/number\",\n  BContextEnd: \"BContextEnd\",\n  FrontendFromUrl: \"Frontend/FromUrl\",\n  FrontendFromFolder: \"Frontend/FromFolder\",\n  BObjectSpec: \"BObjectSpec\",\n  Blob: \"Blob\",\n  Null: \"Null\",\n  Binary: \"binary\",\n  LSProvider: \"LSProvider\",\n  WorkingDirectory: \"WorkingDirectory\",\n  UserProject: \"UserProject\",\n  Projects: \"Projects\",\n  ClientRoot: \"ClientRoot\",\n} as const;\n\n/** Resource type name prefix constants. */\nexport const ResourceTypePrefix = {\n  Blob: \"Blob/\",\n  LS: \"LS/\",\n  WorkingDirectory: \"WorkingDirectory/\",\n  StorageSpaceAllocation: \"StorageSpaceAllocation/\",\n  BlobUpload: \"BlobUpload/\",\n  BlobIndex: \"BlobIndex/\",\n  PColumnData: \"PColumnData/\",\n  StreamWorkdir: \"StreamWorkdir/\",\n} as const;\n"],"mappings":";;AACA,MAAa,mBAAmB;CAC9B,eAAe;CACf,QAAQ;CACR,aAAa;CACb,WAAW;CACX,QAAQ;CACR,cAAc;CACd,UAAU;CACV,iBAAiB;CACjB,WAAW;CACX,aAAa;CACb,SAAS;CACT,gBAAgB;CAChB,wBAAwB;CACxB,cAAc;CACd,eAAe;CACf,UAAU;CACV,cAAc;CACd,OAAO;CACP,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,aAAa;CACb,iBAAiB;CACjB,oBAAoB;CACpB,aAAa;CACb,MAAM;CACN,MAAM;CACN,QAAQ;CACR,YAAY;CACZ,kBAAkB;CAClB,aAAa;CACb,UAAU;CACV,YAAY;CACb;;AAGD,MAAa,qBAAqB;CAChC,MAAM;CACN,IAAI;CACJ,kBAAkB;CAClB,wBAAwB;CACxB,YAAY;CACZ,WAAW;CACX,aAAa;CACb,eAAe;CAChB"}

package/dist/resource_types.d.ts

@@ -33,6 +33,7 @@ declare const ResourceTypeName: {
   readonly Null: "Null";
   readonly Binary: "binary";
   readonly LSProvider: "LSProvider";
+  readonly WorkingDirectory: "WorkingDirectory";
   readonly UserProject: "UserProject";
   readonly Projects: "Projects";
   readonly ClientRoot: "ClientRoot";
@@ -40,6 +41,9 @@ declare const ResourceTypeName: {
 /** Resource type name prefix constants. */
 declare const ResourceTypePrefix: {
   readonly Blob: "Blob/";
+  readonly LS: "LS/";
+  readonly WorkingDirectory: "WorkingDirectory/";
+  readonly StorageSpaceAllocation: "StorageSpaceAllocation/";
   readonly BlobUpload: "BlobUpload/";
   readonly BlobIndex: "BlobIndex/";
   readonly PColumnData: "PColumnData/";

package/dist/resource_types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource_types.d.ts","names":[],"sources":["../src/resource_types.ts"],"mappings":";;cACa,gBAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuCA,kBAAA;EAAA"}
+{"version":3,"file":"resource_types.d.ts","names":[],"sources":["../src/resource_types.ts"],"mappings":";;cACa,gBAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwCA,kBAAA;EAAA"}

package/dist/resource_types.js

@@ -33,6 +33,7 @@ const ResourceTypeName = {
 	Null: "Null",
 	Binary: "binary",
 	LSProvider: "LSProvider",
+	WorkingDirectory: "WorkingDirectory",
 	UserProject: "UserProject",
 	Projects: "Projects",
 	ClientRoot: "ClientRoot"
@@ -40,6 +41,9 @@ const ResourceTypeName = {
 /** Resource type name prefix constants. */
 const ResourceTypePrefix = {
 	Blob: "Blob/",
+	LS: "LS/",
+	WorkingDirectory: "WorkingDirectory/",
+	StorageSpaceAllocation: "StorageSpaceAllocation/",
 	BlobUpload: "BlobUpload/",
 	BlobIndex: "BlobIndex/",
 	PColumnData: "PColumnData/",

package/dist/resource_types.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource_types.js","names":[],"sources":["../src/resource_types.ts"],"sourcesContent":["/** Well-known resource type names used across the platform. */\nexport const ResourceTypeName = {\n  StreamManager: \"StreamManager\",\n  StdMap: \"StdMap\",\n  StdMapSlash: \"std/map\",\n  EphStdMap: \"EphStdMap\",\n  PFrame: \"PFrame\",\n  ParquetChunk: \"ParquetChunk\",\n  BContext: \"BContext\",\n  BlockPackCustom: \"BlockPackCustom\",\n  BinaryMap: \"BinaryMap\",\n  BinaryValue: \"BinaryValue\",\n  BlobMap: \"BlobMap\",\n  BResolveSingle: \"BResolveSingle\",\n  BResolveSingleNoResult: \"BResolveSingleNoResult\",\n  BQueryResult: \"BQueryResult\",\n  TengoTemplate: \"TengoTemplate\",\n  TengoLib: \"TengoLib\",\n  SoftwareInfo: \"SoftwareInfo\",\n  Dummy: \"Dummy\",\n  JsonResourceError: \"json/resourceError\",\n  JsonObject: \"json/object\",\n  JsonGzObject: \"json-gz/object\",\n  JsonString: \"json/string\",\n  JsonArray: \"json/array\",\n  JsonNumber: \"json/number\",\n  BContextEnd: \"BContextEnd\",\n  FrontendFromUrl: \"Frontend/FromUrl\",\n  FrontendFromFolder: \"Frontend/FromFolder\",\n  BObjectSpec: \"BObjectSpec\",\n  Blob: \"Blob\",\n  Null: \"Null\",\n  Binary: \"binary\",\n  LSProvider: \"LSProvider\",\n  UserProject: \"UserProject\",\n  Projects: \"Projects\",\n  ClientRoot: \"ClientRoot\",\n} as const;\n\n/** Resource type name prefix constants. */\nexport const ResourceTypePrefix = {\n  Blob: \"Blob/\",\n  BlobUpload: \"BlobUpload/\",\n  BlobIndex: \"BlobIndex/\",\n  PColumnData: \"PColumnData/\",\n  StreamWorkdir: \"StreamWorkdir/\",\n} as const;\n"],"mappings":";;AACA,MAAa,mBAAmB;CAC9B,eAAe;CACf,QAAQ;CACR,aAAa;CACb,WAAW;CACX,QAAQ;CACR,cAAc;CACd,UAAU;CACV,iBAAiB;CACjB,WAAW;CACX,aAAa;CACb,SAAS;CACT,gBAAgB;CAChB,wBAAwB;CACxB,cAAc;CACd,eAAe;CACf,UAAU;CACV,cAAc;CACd,OAAO;CACP,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,aAAa;CACb,iBAAiB;CACjB,oBAAoB;CACpB,aAAa;CACb,MAAM;CACN,MAAM;CACN,QAAQ;CACR,YAAY;CACZ,aAAa;CACb,UAAU;CACV,YAAY;CACb;;AAGD,MAAa,qBAAqB;CAChC,MAAM;CACN,YAAY;CACZ,WAAW;CACX,aAAa;CACb,eAAe;CAChB"}
+{"version":3,"file":"resource_types.js","names":[],"sources":["../src/resource_types.ts"],"sourcesContent":["/** Well-known resource type names used across the platform. */\nexport const ResourceTypeName = {\n  StreamManager: \"StreamManager\",\n  StdMap: \"StdMap\",\n  StdMapSlash: \"std/map\",\n  EphStdMap: \"EphStdMap\",\n  PFrame: \"PFrame\",\n  ParquetChunk: \"ParquetChunk\",\n  BContext: \"BContext\",\n  BlockPackCustom: \"BlockPackCustom\",\n  BinaryMap: \"BinaryMap\",\n  BinaryValue: \"BinaryValue\",\n  BlobMap: \"BlobMap\",\n  BResolveSingle: \"BResolveSingle\",\n  BResolveSingleNoResult: \"BResolveSingleNoResult\",\n  BQueryResult: \"BQueryResult\",\n  TengoTemplate: \"TengoTemplate\",\n  TengoLib: \"TengoLib\",\n  SoftwareInfo: \"SoftwareInfo\",\n  Dummy: \"Dummy\",\n  JsonResourceError: \"json/resourceError\",\n  JsonObject: \"json/object\",\n  JsonGzObject: \"json-gz/object\",\n  JsonString: \"json/string\",\n  JsonArray: \"json/array\",\n  JsonNumber: \"json/number\",\n  BContextEnd: \"BContextEnd\",\n  FrontendFromUrl: \"Frontend/FromUrl\",\n  FrontendFromFolder: \"Frontend/FromFolder\",\n  BObjectSpec: \"BObjectSpec\",\n  Blob: \"Blob\",\n  Null: \"Null\",\n  Binary: \"binary\",\n  LSProvider: \"LSProvider\",\n  WorkingDirectory: \"WorkingDirectory\",\n  UserProject: \"UserProject\",\n  Projects: \"Projects\",\n  ClientRoot: \"ClientRoot\",\n} as const;\n\n/** Resource type name prefix constants. */\nexport const ResourceTypePrefix = {\n  Blob: \"Blob/\",\n  LS: \"LS/\",\n  WorkingDirectory: \"WorkingDirectory/\",\n  StorageSpaceAllocation: \"StorageSpaceAllocation/\",\n  BlobUpload: \"BlobUpload/\",\n  BlobIndex: \"BlobIndex/\",\n  PColumnData: \"PColumnData/\",\n  StreamWorkdir: \"StreamWorkdir/\",\n} as const;\n"],"mappings":";;AACA,MAAa,mBAAmB;CAC9B,eAAe;CACf,QAAQ;CACR,aAAa;CACb,WAAW;CACX,QAAQ;CACR,cAAc;CACd,UAAU;CACV,iBAAiB;CACjB,WAAW;CACX,aAAa;CACb,SAAS;CACT,gBAAgB;CAChB,wBAAwB;CACxB,cAAc;CACd,eAAe;CACf,UAAU;CACV,cAAc;CACd,OAAO;CACP,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,aAAa;CACb,iBAAiB;CACjB,oBAAoB;CACpB,aAAa;CACb,MAAM;CACN,MAAM;CACN,QAAQ;CACR,YAAY;CACZ,kBAAkB;CAClB,aAAa;CACb,UAAU;CACV,YAAY;CACb;;AAGD,MAAa,qBAAqB;CAChC,MAAM;CACN,IAAI;CACJ,kBAAkB;CAClB,wBAAwB;CACxB,YAAY;CACZ,WAAW;CACX,aAAa;CACb,eAAe;CAChB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.39.0",
+  "version": "1.40.0",
   "description": "Platforma SDK Model",
   "files": [
     "./dist/**/*",
@@ -27,8 +27,8 @@
     "typescript": "~5.9.3",
     "vitest": "^4.1.3",
     "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-builder": "1.3.2",
-    "@milaboratories/ts-configs": "1.2.3"
+    "@milaboratories/ts-configs": "1.2.3",
+    "@milaboratories/ts-builder": "1.4.0"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/drivers/ls.ts

@@ -32,12 +32,12 @@ export type StorageHandleRemote = `remote://${string}`;
 export type StorageHandle = StorageHandleLocal | StorageHandleRemote;
 
 export type StorageEntry = {
+  /** Stable machine identifier (e.g. "library", "root", "local"). Used for filtering. */
+  id: string;
+  /** Human-readable display name. */
   name: string;
   handle: StorageHandle;
   initialFullPath: string;
-
-  // TODO
-  // pathStartsWithDisk
 };
 
 export type ListFilesResult = {

package/src/index.ts

@@ -21,3 +21,4 @@ export * from "./httpAuth";
 export * from "./resource_types";
 export * from "./services";
 export * from "./pool_entry";
+export * from "./project_id";

package/src/project_id.ts

@@ -0,0 +1,11 @@
+import type { Branded } from "./branding";
+
+/**
+ * Opaque identifier for a project, safe to persist and reuse across sessions.
+ * Internally this is a string derived from resource ID without signature.
+ * Unlike SignedResourceId, this does not carry cryptographic signatures and can be
+ * safely persisted, serialized, and reused across ML sessions.
+ * Absence of signature guarantees this ID cannot be used in transactions 'as-is',
+ * requiring the caller to operate with special types and helpers.
+ */
+export type ProjectId = Branded<string, "ProjectId">;

package/src/resource_types.ts

@@ -32,6 +32,7 @@ export const ResourceTypeName = {
   Null: "Null",
   Binary: "binary",
   LSProvider: "LSProvider",
+  WorkingDirectory: "WorkingDirectory",
   UserProject: "UserProject",
   Projects: "Projects",
   ClientRoot: "ClientRoot",
@@ -40,6 +41,9 @@ export const ResourceTypeName = {
 /** Resource type name prefix constants. */
 export const ResourceTypePrefix = {
   Blob: "Blob/",
+  LS: "LS/",
+  WorkingDirectory: "WorkingDirectory/",
+  StorageSpaceAllocation: "StorageSpaceAllocation/",
   BlobUpload: "BlobUpload/",
   BlobIndex: "BlobIndex/",
   PColumnData: "PColumnData/",