@ai-matrx/files

Everything about stored AI Matrx files: upload (simple or resumable, with progress), list, preview and download URLs, bytes, share links, rename / move / copy, delete and restore — every call in an organization. Framework-free core, optional React hooks.

import { createFiles } from "@ai-matrx/files";

const files = createFiles({
  credentials: () => ({ kind: "user", accessToken: session.access_token }),
  organizationId: activeOrganizationId, // a value or a getter
});

const { fileId } = await files.upload(file, { folderPath: "Reports", onProgress });
const rows = await files.list({ folderPath: "Reports" });
const { inline, download } = files.urls(fileId); // durable, never expire
const blob = await files.download(fileId);
const link = await files.createShareLink(fileId); // link.url opens publicly
await files.delete(fileId); // archive
await files.restore(fileId);

| Entry | What | |---|---| | @ai-matrx/files | createFiles + everything below except /tus internals and /react | | @ai-matrx/files/client | The durable-ref engine alone: resolve, blobs, cookie session, heal | | @ai-matrx/files/tus | Resumable transport (tus-js-client loads on the first send) | | @ai-matrx/files/react | FilesProvider, useFiles, useFileUpload, useFileList |

Identity: credentials takes any @ai-matrx/api credentials setting (a credential, a getter or a port). @ai-matrx/auth's session port plugs in there unchanged.

Viewers and players live in @ai-matrx/media; generic database doors in @ai-matrx/data.