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

package/README.md

@@ -3,7 +3,7 @@
 `@yargote/artifacts-contracts` contains strict domain schemas, types, `ArtifactError`, snapshot serialization, and pure retained-edit helpers. It has no database, ZIP, server, or CLI dependency. Node 24 or later is required.
 
 ```sh
-npm install @yargote/artifacts-contracts@0.1.0-beta.3
+npm install @yargote/artifacts-contracts@0.1.0-beta.4
 ```
 
 The root export contains domain schemas and types. `/workflow` contains `prepareArtifactEdit`, revision comparison, and compact projections. `/serialization` contains canonical JSON and SHA-256. `/http` contains HTTP response schemas, identity, canonical resource validation, and route URL helpers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yargote/artifacts-contracts",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.4",
   "private": false,
   "type": "module",
   "description": "Shared schemas and contracts for Artifacts clients.",

package/src/http.d.ts

@@ -50,6 +50,7 @@ export declare const revisionSummarySchema: z.ZodObject<{
 export declare const compactArtifactReadSchema: z.ZodObject<{
     ownerId: z.ZodString;
     headRevisionId: z.ZodString;
+    project: z.ZodNullable<z.ZodString>;
     artifactId: z.ZodString;
     publication: z.ZodNullable<z.ZodObject<{
         revisionId: z.ZodString;
@@ -93,6 +94,7 @@ export declare const artifactSummarySchema: z.ZodObject<{
     title: z.ZodString;
     headRevisionId: z.ZodString;
     createdAt: z.ZodISODateTime;
+    project: z.ZodNullable<z.ZodString>;
     publication: z.ZodNullable<z.ZodObject<{
         revisionId: z.ZodString;
         version: z.ZodNumber;
@@ -105,6 +107,7 @@ export declare const listResultSchema: z.ZodObject<{
         title: z.ZodString;
         headRevisionId: z.ZodString;
         createdAt: z.ZodISODateTime;
+        project: z.ZodNullable<z.ZodString>;
         publication: z.ZodNullable<z.ZodObject<{
             revisionId: z.ZodString;
             version: z.ZodNumber;
@@ -113,6 +116,16 @@ export declare const listResultSchema: z.ZodObject<{
     }, z.core.$strict>>;
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
+export declare const projectSummarySchema: z.ZodObject<{
+    name: z.ZodString;
+    artifactCount: z.ZodNumber;
+}, z.core.$strict>;
+export declare const projectsResultSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        artifactCount: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export declare const historyResultSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;

package/src/http.js

@@ -10,8 +10,10 @@ export const revisionSummarySchema = revisionSchema.omit({ snapshot: true }).ext
     files: z.array(attachmentSummarySchema).max(32),
 });
 export const compactArtifactReadSchema = artifactReadSchema.omit({ revision: true }).extend({ revision: revisionSummarySchema });
-export const artifactSummarySchema = z.strictObject({ artifactId: identifier, title: z.string(), headRevisionId: identifier, createdAt: z.iso.datetime(), publication: publicationSchema.nullable() });
+export const artifactSummarySchema = z.strictObject({ artifactId: identifier, title: z.string(), headRevisionId: identifier, createdAt: z.iso.datetime(), project: z.string().nullable(), publication: publicationSchema.nullable() });
 export const listResultSchema = z.strictObject({ items: z.array(artifactSummarySchema).max(100), nextCursor: identifier.nullable() });
+export const projectSummarySchema = z.strictObject({ name: z.string(), artifactCount: z.number().int().positive() });
+export const projectsResultSchema = z.strictObject({ items: z.array(projectSummarySchema) });
 export const historyResultSchema = z.strictObject({ items: z.array(revisionSchema).max(10), nextBeforeSequence: z.number().int().positive().nullable() });
 export const summaryHistoryResultSchema = historyResultSchema.extend({ items: z.array(revisionSummarySchema).max(10) });
 export const httpErrorSchema = z.strictObject({ error: z.strictObject({ code: z.string().min(1), message: z.string(), details: z.record(z.string(), z.unknown()) }) });

package/src/index.d.ts

@@ -23,6 +23,7 @@ export declare const snapshotSchema: z.ZodObject<{
         data: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+export declare const projectNameSchema: z.ZodString;
 export declare const createSchema: z.ZodObject<{
     requestId: z.ZodString;
     snapshot: z.ZodObject<{
@@ -49,6 +50,7 @@ export declare const createSchema: z.ZodObject<{
             data: z.ZodString;
         }, z.core.$strict>>;
     }, z.core.$strict>;
+    project: z.ZodOptional<z.ZodString>;
     response: z.ZodOptional<z.ZodEnum<{
         full: "full";
         compact: "compact";
@@ -112,6 +114,16 @@ export declare const deleteResultSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type DeleteInput = z.infer<typeof deleteSchema>;
 export type DeleteResult = z.infer<typeof deleteResultSchema>;
+export declare const moveSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    artifactId: z.ZodString;
+    project: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const moveResultSchema: z.ZodObject<{
+    artifactId: z.ZodString;
+    project: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type MoveResult = z.infer<typeof moveResultSchema>;
 export declare const exportSchema: z.ZodObject<{
     artifactId: z.ZodString;
     revisionId: z.ZodString;
@@ -119,6 +131,7 @@ export declare const exportSchema: z.ZodObject<{
 export declare const listSchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodNumber>;
     cursor: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const libraryQuerySchema: z.ZodObject<{
     q: z.ZodDefault<z.ZodString>;
@@ -128,6 +141,7 @@ export declare const libraryQuerySchema: z.ZodObject<{
         unpublished: "unpublished";
         pending: "pending";
     }>>;
+    project: z.ZodOptional<z.ZodString>;
     cursor: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const historySchema: z.ZodObject<{
@@ -188,8 +202,13 @@ export type ArtifactSummary = {
     title: string;
     headRevisionId: string;
     createdAt: string;
+    project: string | null;
     publication: Publication | null;
 };
+export type ProjectSummary = {
+    name: string;
+    artifactCount: number;
+};
 export type ArtifactLibraryQuery = z.infer<typeof libraryQuerySchema>;
 export type ArtifactLibraryPage = {
     items: ArtifactSummary[];
@@ -259,6 +278,7 @@ export declare const artifactReadSchema: z.ZodObject<{
     artifactId: z.ZodString;
     ownerId: z.ZodString;
     headRevisionId: z.ZodString;
+    project: z.ZodNullable<z.ZodString>;
     publication: z.ZodNullable<z.ZodObject<{
         revisionId: z.ZodString;
         version: z.ZodNumber;

package/src/index.js

@@ -22,18 +22,22 @@ export const snapshotSchema = z.strictObject({
     if (bytes > 1_048_576)
         context.addIssue({ code: 'custom', message: 'A revision must fit within 1 MiB of decoded content and metadata' });
 });
+export const projectNameSchema = z.string().normalize('NFC').trim().min(1).max(80).refine((name) => name.isWellFormed() && !/\p{Cc}/u.test(name), 'Use a project name without control characters');
 const response = z.enum(['full', 'compact']).optional();
-export const createSchema = z.strictObject({ requestId, snapshot: snapshotSchema, response });
+export const createSchema = z.strictObject({ requestId, snapshot: snapshotSchema, project: projectNameSchema.optional(), response });
 export const readSchema = z.strictObject({ artifactId: identifier, revisionId: identifier.optional(), response });
 export const updateSchema = z.strictObject({ requestId, artifactId: identifier, expectedRevisionId: identifier, snapshot: snapshotSchema, response });
 export const publishSchema = z.strictObject({ requestId, artifactId: identifier, revisionId: identifier, expectedPublicationVersion: z.number().int().nonnegative() });
 export const deleteSchema = z.strictObject({ requestId, artifactId: identifier, expectedRevisionId: identifier, expectedPublicationVersion: z.number().int().nonnegative() });
 export const deleteResultSchema = z.strictObject({ artifactId: identifier });
+export const moveSchema = z.strictObject({ requestId, artifactId: identifier, project: projectNameSchema.nullable() });
+export const moveResultSchema = z.strictObject({ artifactId: identifier, project: z.string().nullable() });
 export const exportSchema = z.strictObject({ artifactId: identifier, revisionId: identifier });
-export const listSchema = z.strictObject({ limit: z.number().int().min(1).max(100).default(25), cursor: identifier.optional() });
+export const listSchema = z.strictObject({ limit: z.number().int().min(1).max(100).default(25), cursor: identifier.optional(), project: projectNameSchema.optional() });
 export const libraryQuerySchema = z.strictObject({
     q: z.string().trim().max(256).default(''),
     status: z.enum(['all', 'published', 'unpublished', 'pending']).default('all'),
+    project: projectNameSchema.optional(),
     cursor: identifier.optional(),
 });
 export const historySchema = z.strictObject({ artifactId: identifier, limit: z.number().int().min(1).max(10).default(5), beforeSequence: z.number().int().positive().optional(), response: z.enum(['full', 'summary']).optional() });
@@ -54,5 +58,5 @@ export function decodeFile(file) {
 }
 export const publicationSchema = z.strictObject({ revisionId: identifier, version: z.number().int().positive(), url: z.url() });
 export const revisionSchema = z.strictObject({ id: identifier, parentRevisionId: identifier.nullable(), sequence: z.number().int().positive(), authorUserId: identifier, authorClientId: identifier, createdAt: z.iso.datetime(), sha256: z.string().regex(/^[a-f0-9]{64}$/), snapshot: snapshotSchema });
-export const artifactReadSchema = z.strictObject({ artifactId: identifier, ownerId: identifier, headRevisionId: identifier, publication: publicationSchema.nullable(), revision: revisionSchema });
+export const artifactReadSchema = z.strictObject({ artifactId: identifier, ownerId: identifier, headRevisionId: identifier, project: z.string().nullable(), publication: publicationSchema.nullable(), revision: revisionSchema });
 export const publishResultSchema = publicationSchema.extend({ artifactId: identifier });