@yargote/artifacts-client 0.1.0-beta.3 → 0.1.0-beta.4

package/README.md

@@ -3,7 +3,7 @@
 `@yargote/artifacts-client` is a typed Fetch client for the Artifacts REST API. It depends on `@yargote/artifacts-contracts` and Zod. It does not install the artifact store or a database driver. Node 24 or later is required.
 
 ```sh
-npm install @yargote/artifacts-client@0.1.0-beta.3
+npm install @yargote/artifacts-client@0.1.0-beta.4
 ```
 
 ```ts
@@ -36,18 +36,22 @@ Every method makes one HTTP request. The client does not retry, follow redirects
 | Method | Input | Result |
 | --- | --- | --- |
 | `identity()` | None | Verified user, session, client, and scopes |
-| `create(command)` | `requestId`, complete `snapshot`, optional `response` | Artifact receipt |
-| `list(query?)` | Optional `limit` and `cursor` | Artifact summaries and `nextCursor` |
+| `create(command)` | `requestId`, complete `snapshot`, optional `project` and `response` | Artifact receipt |
+| `list(query?)` | Optional `limit`, `cursor`, and `project` | Artifact summaries and `nextCursor` |
+| `projects()` | None | `{ items: [{ name, artifactCount }] }` |
 | `read(query)` | `artifactId`, optional `revisionId` and `response` | Artifact revision |
 | `update(command)` | `requestId`, `artifactId`, `expectedRevisionId`, complete `snapshot`, optional `response` | Artifact receipt |
 | `history(query)` | `artifactId`, optional `limit`, `beforeSequence`, and `response` | Revisions and `nextBeforeSequence` |
 | `publish(command)` | `requestId`, `artifactId`, `revisionId`, `expectedPublicationVersion` | Publication receipt |
+| `move(command)` | `requestId`, `artifactId`, `project` name or null | `{ artifactId, project }` |
 | `export(query)` | `artifactId`, `revisionId` | `{ filename, mediaType, bytes, sha256 }` |
 
 Create, read, and update accept `response: 'compact'`. The returned revision contains metadata and file summaries. Omitted response and `response: 'full'` return the complete snapshot. History accepts `response: 'summary'` or `response: 'full'`. Its page limit is ten revisions. Overloads reflect these projections in the return type.
 
 All commands and JSON responses pass the strict domain schemas. An omitted mutation `response` remains omitted in the transmitted command. JSON responses are bounded at 64 MiB, which accommodates ten maximum-size revisions with JSON escaping. Archives are bounded at 8 MiB. Export verifies the binary bytes against `X-Artifact-SHA256` and returns the bytes without rebuilding the ZIP.
 
+Artifact reads and list items include `project`, a name or null. A project name matches an existing project regardless of letter case and keeps its stored spelling. `move` never creates a revision or changes the publication. `projects()` lists only projects that contain artifacts, ordered by name. Because response schemas are strict, this client requires a server that returns `project`. Version `0.1.0-beta.4` and earlier reject responses from such a server with `invalid_response`.
+
 `prepareArtifactEdit(client, { artifactId, requestId, changes })` reads the current full snapshot and prepares an immutable update command. Metadata and content changes merge into that snapshot. An explicit `files` array replaces the attachments. The helper does not submit the update. Retain its exact output before sending it.
 
 ## Errors and retries
@@ -56,7 +60,7 @@ All commands and JSON responses pass the strict domain schemas. An omitted mutat
 
 Invalid local commands throw a Zod validation error before any HTTP request. Invalid configuration throws `TypeError`.
 
-A caller that needs recovery retains the complete create, update, or publish command before its first request. While the artifact exists, retrying that exact command returns the original receipt. Changing `response`, the snapshot, or any expected version changes the command. A conflict requires a new deliberate command with a new request ID. A replayed receipt describes the original operation and can differ from a fresh read.
+A caller that needs recovery retains the complete create, update, publish, or move command before its first request. While the artifact exists, retrying that exact command returns the original receipt. Changing `response`, the snapshot, or any expected version changes the command. A conflict requires a new deliberate command with a new request ID. A replayed receipt describes the original operation and can differ from a fresh read.
 
 ## Compiled installation
 
@@ -64,4 +68,4 @@ The registry package contains compiled ESM JavaScript and declarations. Consumer
 
 This package is MIT licensed. The license applies to this package and does not license the private Artifacts application repository.
 
-Permanent deletion from the panel invalidates historical content-bearing receipts. An exact create, update or publish retry for a deleted artifact returns `not_found`; request identity remains reserved, so a changed command still returns `request_conflict` and an old create cannot recreate it. Live-session and scope checks still precede replay. This package exposes no deletion operation.
+Permanent deletion from the panel invalidates historical content-bearing receipts. An exact create, update, publish or move retry for a deleted artifact returns `not_found`; request identity remains reserved, so a changed command still returns `request_conflict` and an old create cannot recreate it. Live-session and scope checks still precede replay. This package exposes no deletion operation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yargote/artifacts-client",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.4",
   "private": false,
   "type": "module",
   "description": "Typed HTTP client for the Artifacts REST API.",
@@ -26,7 +26,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@yargote/artifacts-contracts": "0.1.0-beta.3",
+    "@yargote/artifacts-contracts": "0.1.0-beta.4",
     "zod": "4.6.5"
   },
   "publishConfig": {

package/src/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { createSchema, exportSchema, historySchema, listSchema, publishResultSchema, publishSchema, readSchema, type ArtifactRead, type UpdateInput } from '@yargote/artifacts-contracts';
-import { historyResultSchema, listResultSchema, summaryHistoryResultSchema, type Identity } from '@yargote/artifacts-contracts/http';
+import { createSchema, exportSchema, historySchema, listSchema, moveResultSchema, moveSchema, publishResultSchema, publishSchema, readSchema, type ArtifactRead, type UpdateInput } from '@yargote/artifacts-contracts';
+import { historyResultSchema, listResultSchema, projectsResultSchema, summaryHistoryResultSchema, type Identity } from '@yargote/artifacts-contracts/http';
 import type { CompactArtifactRead } from '@yargote/artifacts-contracts/workflow';
 export type { ArtifactRead, Snapshot, UpdateInput } from '@yargote/artifacts-contracts';
 export type { Identity } from '@yargote/artifacts-contracts/http';
@@ -10,6 +10,9 @@ export type CreateInput = z.input<typeof createSchema>;
 export type ReadInput = z.input<typeof readSchema>;
 export type PublishInput = z.input<typeof publishSchema>;
 export type ListInput = z.input<typeof listSchema>;
+export type MoveInput = z.input<typeof moveSchema>;
+export type MoveResult = z.infer<typeof moveResultSchema>;
+export type ProjectsResult = z.infer<typeof projectsResultSchema>;
 export type HistoryInput = z.input<typeof historySchema>;
 export type ExportInput = z.input<typeof exportSchema>;
 export type ArtifactArchive = {
@@ -36,6 +39,7 @@ export interface ArtifactHttpClient {
     }): Promise<ArtifactRead>;
     create(input: CreateInput): Promise<ArtifactRead | CompactArtifactRead>;
     list(input?: ListInput): Promise<z.infer<typeof listResultSchema>>;
+    projects(): Promise<ProjectsResult>;
     read(input: ReadInput & {
         response: 'compact';
     }): Promise<CompactArtifactRead>;
@@ -58,6 +62,7 @@ export interface ArtifactHttpClient {
     }): Promise<HistoryResult>;
     history(input: HistoryInput): Promise<HistoryResult | SummaryHistoryResult>;
     publish(input: PublishInput): Promise<z.infer<typeof publishResultSchema>>;
+    move(input: MoveInput): Promise<MoveResult>;
     export(input: ExportInput): Promise<ArtifactArchive>;
 }
 export declare function createArtifactHttpClient(options: {

package/src/index.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { artifactReadSchema, createSchema, exportSchema, historySchema, listSchema, publishResultSchema, publishSchema, readSchema, updateSchema } from '@yargote/artifacts-contracts';
-import { compactArtifactReadSchema, historyResultSchema, httpErrorSchema, identitySchema, listResultSchema, restBase, summaryHistoryResultSchema } from '@yargote/artifacts-contracts/http';
+import { artifactReadSchema, createSchema, exportSchema, historySchema, listSchema, moveResultSchema, moveSchema, publishResultSchema, publishSchema, readSchema, updateSchema } from '@yargote/artifacts-contracts';
+import { compactArtifactReadSchema, historyResultSchema, httpErrorSchema, identitySchema, listResultSchema, projectsResultSchema, restBase, summaryHistoryResultSchema } from '@yargote/artifacts-contracts/http';
 export { prepareArtifactEdit } from '@yargote/artifacts-contracts/workflow';
 export class HttpError extends Error {
     status;
@@ -140,6 +140,7 @@ export function createArtifactHttpClient(options) {
         list(value = {}) {
             return json(`/artifacts${query(listSchema.parse(value))}`, 'GET', listResultSchema);
         },
+        projects: () => json('/projects', 'GET', projectsResultSchema),
         read(value) {
             const { artifactId, ...parameters } = readSchema.parse(value);
             return json(`/artifacts/${encodeURIComponent(artifactId)}${query(parameters)}`, 'GET', parameters.response === 'compact' ? compactArtifactReadSchema : artifactReadSchema);
@@ -156,6 +157,10 @@ export function createArtifactHttpClient(options) {
             const input = publishSchema.parse(value);
             return json(`/artifacts/${encodeURIComponent(input.artifactId)}/publication`, 'PUT', publishResultSchema, input);
         },
+        move(value) {
+            const input = moveSchema.parse(value);
+            return json(`/artifacts/${encodeURIComponent(input.artifactId)}/project`, 'PUT', moveResultSchema, input);
+        },
         export(value) {
             const input = exportSchema.parse(value);
             return request(`/artifacts/${encodeURIComponent(input.artifactId)}/revisions/${encodeURIComponent(input.revisionId)}/export`, 'GET', async (response, bytes) => {