@absolutejs/artifacts 0.0.1 → 0.0.3

package/dist/src/types.d.ts

@@ -1,18 +1,52 @@
 export declare const ARTIFACT_STATUSES: readonly ["draft", "published", "archived"];
 export type ArtifactStatus = (typeof ARTIFACT_STATUSES)[number];
-export type ArtifactCapability = "archive" | "edit" | "export" | "preview" | "publish" | "refine";
+export type ArtifactCapability = "attach" | "archive" | "edit" | "export" | "preview" | "publish" | "refine";
 export type ArtifactProvenance = {
+    lineage?: ArtifactLineageReference[];
     model?: string;
     sourceIds?: string[];
     tool?: string;
     traceId?: string;
 };
+export type ArtifactLineageRelation = "derived_from" | "generated_from" | "references" | "replaces";
+export type ArtifactLineageReference = {
+    artifactId?: string;
+    relation: ArtifactLineageRelation;
+    revision?: number;
+    sourceId?: string;
+};
 export type ArtifactPublication = {
     id: string;
+    mode: "live" | "pinned";
     publishedAt: string;
+    revision: number;
     url: string;
 };
+export type ArtifactAssetRole = "attachment" | "primary" | "preview" | "source";
+export type ArtifactAssetReference = {
+    checksum?: {
+        algorithm: "sha256";
+        value: string;
+    };
+    id: string;
+    createdAt: string;
+    mediaType: string;
+    metadata?: Record<string, unknown>;
+    name: string;
+    role: ArtifactAssetRole;
+    size: number;
+    /** Opaque host storage locator. It is not required to be publicly fetchable. */
+    uri: string;
+};
+export type ArtifactAssetWriteInput = {
+    data: Uint8Array;
+    mediaType: string;
+    metadata?: Record<string, unknown>;
+    name: string;
+    role?: ArtifactAssetRole;
+};
 export type ArtifactRecord<TContent = unknown> = {
+    assets: ArtifactAssetReference[];
     capabilities: ArtifactCapability[];
     content: TContent;
     createdAt: string;
@@ -29,12 +63,42 @@ export type ArtifactRecord<TContent = unknown> = {
     title: string;
     updatedAt: string;
 };
+export declare const ARTIFACT_EVENT_TYPES: readonly ["artifact.archived", "artifact.asset_attached", "artifact.asset_detached", "artifact.created", "artifact.generated", "artifact.indexing_changed", "artifact.published", "artifact.restored", "artifact.revised", "artifact.unpublished"];
+export type ArtifactEventType = (typeof ARTIFACT_EVENT_TYPES)[number];
+export type ArtifactEvent = {
+    artifactId: string;
+    createdAt: string;
+    id: string;
+    ownerId: string;
+    payload?: Record<string, unknown>;
+    processedAt?: string;
+    revision: number;
+    type: ArtifactEventType;
+};
+export type ArtifactEventQuery = {
+    limit?: number;
+    processed?: boolean;
+    type?: ArtifactEventType;
+};
+export type ArtifactIndexingStatus = "failed" | "indexed" | "pending" | "stale";
+export type ArtifactIndexingState = {
+    artifactId: string;
+    documentIds: string[];
+    error?: string;
+    indexedAt?: string;
+    revision: number;
+    status: ArtifactIndexingStatus;
+    updatedAt: string;
+};
+/** An immutable point-in-time copy of an artifact record. */
+export type ArtifactRevision<TContent = unknown> = Readonly<ArtifactRecord<TContent>>;
 export type ArtifactListQuery = {
     kind?: string;
     limit?: number;
     status?: ArtifactStatus;
 };
 export type ArtifactCreateInput = {
+    assets?: ArtifactAssetReference[];
     content: unknown;
     createdBy: string;
     kind: string;
@@ -43,12 +107,27 @@ export type ArtifactCreateInput = {
     title: string;
 };
 export type ArtifactUpdateInput = {
+    assets?: ArtifactAssetReference[];
     content?: unknown;
     expectedRevision?: number;
     metadata?: Record<string, unknown>;
     title?: string;
 };
-export type ArtifactErrorCode = "conflict" | "invalid_content" | "not_found" | "publisher_unavailable" | "renderer_unavailable" | "unsupported_capability" | "unknown_kind";
+export type ArtifactBundleCreateInput = Omit<ArtifactCreateInput, "assets"> & {
+    assets?: ArtifactAssetWriteInput[];
+};
+export type ArtifactPublishInput = {
+    mode?: "live" | "pinned";
+};
+export type ArtifactRetentionCandidate = {
+    createdAt: string;
+    reference: ArtifactAssetReference;
+};
+export type ArtifactGarbageCollectionResult = {
+    deleted: ArtifactAssetReference[];
+    retained: ArtifactAssetReference[];
+};
+export type ArtifactErrorCode = "asset_store_unavailable" | "asset_transaction_unavailable" | "conflict" | "generator_unavailable" | "invalid_content" | "not_found" | "publisher_unavailable" | "renderer_unavailable" | "unsupported_capability" | "unknown_kind";
 export declare class ArtifactError extends Error {
     readonly code: ArtifactErrorCode;
     constructor(code: ArtifactErrorCode, message: string);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/artifacts",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Typed, versioned artifacts for AI products — schemas, lifecycle, storage, rendering, publishing, revisions, and agent tools without prescribing a database or host.",
   "author": "Alex Kahn",
   "license": "BUSL-1.1",
@@ -14,14 +14,14 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/absolutejs/artifacts.git"
+    "url": "git+https://github.com/absolutejs/artifacts.git"
   },
   "homepage": "https://github.com/absolutejs/artifacts",
   "bugs": {
     "url": "https://github.com/absolutejs/artifacts/issues"
   },
   "scripts": {
-    "build": "rm -rf dist && bun build src/index.ts src/manifest.ts --outdir dist --root ./src --target=bun --external @sinclair/typebox --external @sinclair/typebox/value && tsc --emitDeclarationOnly --project tsconfig.json && absolute-manifest emit",
+    "build": "rm -rf dist && bun build src/index.ts src/manifest.ts src/rag.ts --outdir dist --root ./src --target=bun --external @absolutejs/rag --external @sinclair/typebox --external @sinclair/typebox/value && tsc --emitDeclarationOnly --project tsconfig.json && absolute-manifest emit",
     "format": "prettier --write \"./**/*.{ts,json,md}\"",
     "release": "bun run format && bun run test && bun run build && bun publish",
     "test": "bun test",
@@ -44,13 +44,27 @@
       "import": "./dist/manifest.js",
       "default": "./dist/manifest.js"
     },
-    "./manifest.json": "./dist/manifest.json"
+    "./manifest.json": "./dist/manifest.json",
+    "./rag": {
+      "types": "./dist/src/rag.d.ts",
+      "import": "./dist/rag.js",
+      "default": "./dist/rag.js"
+    }
   },
   "dependencies": {
     "@absolutejs/manifest": "^0.1.0",
     "@sinclair/typebox": "^0.34.0"
   },
+  "peerDependencies": {
+    "@absolutejs/rag": ">=0.0.29"
+  },
+  "peerDependenciesMeta": {
+    "@absolutejs/rag": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@absolutejs/rag": "0.0.29",
     "@types/bun": "latest",
     "prettier": "3.5.3",
     "typescript": "5.8.3"