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

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.4
+npm install @yargote/artifacts-contracts@0.1.0-beta.6
 ```
 
 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.
@@ -11,3 +11,5 @@ The root export contains domain schemas and types. `/workflow` contains `prepare
 The existing `@artifacts/artifacts` root, `/contracts`, and `/workflow` exports re-export these implementations. Store and REST packages share one `ArtifactError` runtime.
 
 This package is MIT licensed. The license applies to this package and does not license the private Artifacts application repository.
+
+`shareSchema` accepts optional `notify` and `requireNew: true` without defaults. `shareResultSchema` remains the strict five-field grant shape used by lists. `shareCommandResultSchema` adds an optional immutable notification disposition for commands. Plain and explicit-false requests return the original grant shape. An absent flag and an explicit false remain distinct receipt arguments.

package/package.json

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

package/src/index.d.ts

@@ -124,6 +124,63 @@ export declare const moveResultSchema: z.ZodObject<{
     project: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export type MoveResult = z.infer<typeof moveResultSchema>;
+export declare const shareSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    artifactId: z.ZodString;
+    email: z.ZodPipe<z.ZodString, z.ZodEmail>;
+    notify: z.ZodOptional<z.ZodBoolean>;
+    requireNew: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>;
+export declare const unshareSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    artifactId: z.ZodString;
+    shareId: z.ZodString;
+}, z.core.$strict>;
+export declare const listSharesSchema: z.ZodObject<{
+    artifactId: z.ZodString;
+}, z.core.$strict>;
+export declare const shareResultSchema: z.ZodObject<{
+    shareId: z.ZodString;
+    artifactId: z.ZodString;
+    kind: z.ZodLiteral<"email">;
+    value: z.ZodEmail;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const notificationSchema: z.ZodUnion<readonly [z.ZodObject<{
+    status: z.ZodLiteral<"requested">;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"skipped">;
+    reason: z.ZodLiteral<"disabled">;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"skipped">;
+    reason: z.ZodLiteral<"rate_limited">;
+    retryAt: z.ZodISODateTime;
+}, z.core.$strict>]>;
+export declare const shareCommandResultSchema: z.ZodObject<{
+    shareId: z.ZodString;
+    artifactId: z.ZodString;
+    kind: z.ZodLiteral<"email">;
+    value: z.ZodEmail;
+    createdAt: z.ZodISODateTime;
+    notification: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        status: z.ZodLiteral<"requested">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"skipped">;
+        reason: z.ZodLiteral<"disabled">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"skipped">;
+        reason: z.ZodLiteral<"rate_limited">;
+        retryAt: z.ZodISODateTime;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
+export declare const unshareResultSchema: z.ZodObject<{
+    artifactId: z.ZodString;
+    shareId: z.ZodString;
+}, z.core.$strict>;
+export type Share = z.infer<typeof shareResultSchema>;
+export type ShareResult = z.infer<typeof shareCommandResultSchema>;
+export type Notification = z.infer<typeof notificationSchema>;
+export type UnshareResult = z.infer<typeof unshareResultSchema>;
 export declare const exportSchema: z.ZodObject<{
     artifactId: z.ZodString;
     revisionId: z.ZodString;
@@ -197,6 +254,13 @@ export type Viewer = z.infer<typeof viewerSchema>;
 export type Publication = z.infer<typeof publicationSchema>;
 export type Revision = z.infer<typeof revisionSchema>;
 export type ArtifactRead = z.infer<typeof artifactReadSchema>;
+export type SharedRead = z.infer<typeof sharedReadSchema>;
+export type SharedArtifactSummary = Readonly<{
+    artifactId: string;
+    title: string;
+    ownerName: string;
+    url: string;
+}>;
 export type ArtifactSummary = {
     artifactId: string;
     title: string;
@@ -318,6 +382,44 @@ export declare const artifactReadSchema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export declare const sharedReadSchema: z.ZodObject<{
+    artifactId: z.ZodString;
+    ownerName: z.ZodDefault<z.ZodString>;
+    publication: z.ZodObject<{
+        revisionId: z.ZodString;
+        version: z.ZodNumber;
+        url: z.ZodURL;
+    }, z.core.$strict>;
+    revision: z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        sha256: z.ZodString;
+        snapshot: z.ZodObject<{
+            metadata: z.ZodObject<{
+                title: z.ZodString;
+                description: z.ZodString;
+                custom: z.ZodOptional<z.ZodJSONSchema>;
+            }, z.core.$strict>;
+            content: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    text: "text";
+                    html: "html";
+                    markdown: "markdown";
+                }>;
+                text: z.ZodString;
+            }, z.core.$strict>;
+            files: z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                mediaType: z.ZodString;
+                encoding: z.ZodEnum<{
+                    utf8: "utf8";
+                    base64: "base64";
+                }>;
+                data: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export declare const publishResultSchema: z.ZodObject<{
     revisionId: z.ZodString;
     version: z.ZodNumber;

package/src/index.js

@@ -32,6 +32,17 @@ export const deleteSchema = z.strictObject({ requestId, artifactId: identifier,
 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 shareSchema = z.strictObject({ requestId, artifactId: identifier, email: z.string().trim().toLowerCase().pipe(z.email().max(254)).meta({ format: 'email', description: 'Email address, trimmed and lowercased; at most 254 characters after trimming' }), notify: z.boolean().optional(), requireNew: z.literal(true).optional() });
+export const unshareSchema = z.strictObject({ requestId, artifactId: identifier, shareId: identifier });
+export const listSharesSchema = z.strictObject({ artifactId: identifier });
+export const shareResultSchema = z.strictObject({ shareId: identifier, artifactId: identifier, kind: z.literal('email'), value: z.email(), createdAt: z.iso.datetime() });
+export const notificationSchema = z.union([
+    z.strictObject({ status: z.literal('requested') }),
+    z.strictObject({ status: z.literal('skipped'), reason: z.literal('disabled') }),
+    z.strictObject({ status: z.literal('skipped'), reason: z.literal('rate_limited'), retryAt: z.iso.datetime() }),
+]);
+export const shareCommandResultSchema = shareResultSchema.extend({ notification: notificationSchema.optional() });
+export const unshareResultSchema = z.strictObject({ artifactId: identifier, shareId: identifier });
 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(), project: projectNameSchema.optional() });
 export const libraryQuerySchema = z.strictObject({
@@ -59,4 +70,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, project: z.string().nullable(), publication: publicationSchema.nullable(), revision: revisionSchema });
+export const sharedReadSchema = z.strictObject({ artifactId: identifier, ownerName: z.string().default('Usuario de Artifacts'), publication: publicationSchema, revision: revisionSchema.pick({ id: true, createdAt: true, sha256: true, snapshot: true }) });
 export const publishResultSchema = publicationSchema.extend({ artifactId: identifier });