@aigne/afs-history 1.2.0 → 1.3.0-beta

package/CHANGELOG.md

@@ -6,6 +6,20 @@
   * dependencies
     * @aigne/afs bumped to 1.2.0
 
+## [1.3.0-beta](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0...afs-history-v1.3.0-beta) (2026-01-20)
+
+
+### Features
+
+* **afs:** add @aigne/afs-utils package ([#927](https://github.com/AIGNE-io/aigne-framework/issues/927)) ([3922635](https://github.com/AIGNE-io/aigne-framework/commit/3922635981aab4578607c5bf1fb882c8e45725ce))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-utils bumped to 1.0.0
+
 ## [1.2.0](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0-beta.12...afs-history-v1.2.0) (2026-01-16)
 
 

package/lib/cjs/index.d.ts

@@ -1,9 +1,9 @@
 import { type AFSAccessMode, type AFSDeleteOptions, type AFSDeleteResult, type AFSListOptions, type AFSListResult, type AFSModule, type AFSModuleLoadParams, type AFSReadOptions, type AFSReadResult, type AFSRoot, type AFSWriteEntryPayload, type AFSWriteOptions, type AFSWriteResult } from "@aigne/afs";
 import { z } from "zod";
-import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
+import { type AFSStorage, type AFSStorageSQLiteOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
-    storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    storage?: AFSStorage | AFSStorageSQLiteOptions;
     /**
      * Access mode for this module.
      * @default "readwrite"
@@ -11,26 +11,19 @@ export interface AFSHistoryOptions {
     accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
-    static schema(): z.ZodObject<{
-        storage: z.ZodOptional<z.ZodObject<{
-            url: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            url?: string | undefined;
-        }, {
-            url?: string | undefined;
-        }>>;
+    static schema(): z.ZodEffects<z.ZodObject<{
+        storage: z.ZodType<any, z.ZodTypeDef, any>;
         accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
     }, "strip", z.ZodTypeAny, {
-        storage?: {
-            url?: string | undefined;
-        } | undefined;
+        storage?: any;
         accessMode?: "readonly" | "readwrite" | undefined;
     }, {
-        storage?: {
-            url?: string | undefined;
-        } | undefined;
+        storage?: any;
         accessMode?: "readonly" | "readwrite" | undefined;
-    }>;
+    }>, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, any>;
     static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;

package/lib/cjs/index.js

@@ -16,22 +16,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSHistory = void 0;
 const afs_1 = require("@aigne/afs");
+const index_js_1 = require("@aigne/afs-utils/zod/index.js");
 const uuid_1 = require("@aigne/uuid");
 const radix3_1 = require("radix3");
 const ufo_1 = require("ufo");
 const zod_1 = require("zod");
-const index_js_1 = require("./storage/index.js");
+const index_js_2 = require("./storage/index.js");
 __exportStar(require("./storage/index.js"), exports);
-const sharedAFSStorageOptionsSchema = zod_1.z.object({
-    url: zod_1.z.string().describe("Database URL for storage").optional(),
-});
-const afsHistoryOptionsSchema = preprocessSchema((v) => {
-    if (!v || typeof v !== "object") {
-        return v;
-    }
-    return { ...v, accessMode: v.accessMode || v.access_mode };
-}, zod_1.z.object({
-    storage: sharedAFSStorageOptionsSchema.optional(),
+const afsStorageOptionsSchema = (0, index_js_1.camelize)(zod_1.z.object({
+    url: (0, index_js_1.optionalize)(zod_1.z.string().describe("Database URL for storage")),
+}));
+const afsHistoryOptionsSchema = (0, index_js_1.camelize)(zod_1.z.object({
+    storage: (0, index_js_1.optionalize)(zod_1.z.union([zod_1.z.custom((v) => (0, index_js_2.isAFSStorage)(v)), afsStorageOptionsSchema])),
     accessMode: afs_1.accessModeSchema,
 }));
 class AFSHistory {
@@ -43,10 +39,10 @@ class AFSHistory {
         return new AFSHistory(valid);
     }
     constructor(options) {
-        this.storage =
-            options?.storage instanceof index_js_1.SharedAFSStorage
-                ? options.storage.withModule(this)
-                : new index_js_1.SharedAFSStorage(options?.storage).withModule(this);
+        (0, index_js_1.zodParse)((0, index_js_1.optionalize)(afsHistoryOptionsSchema), options);
+        this.storage = (0, index_js_2.isAFSStorage)(options?.storage)
+            ? options.storage
+            : new index_js_2.AFSStorageSQLite(this, options?.storage);
         this.accessMode = options?.accessMode ?? "readwrite";
     }
     name = "history";
@@ -276,6 +272,3 @@ class AFSHistory {
 }
 exports.AFSHistory = AFSHistory;
 const _typeCheck = AFSHistory;
-function preprocessSchema(fn, schema) {
-    return zod_1.z.preprocess(fn, schema);
-}

package/lib/cjs/storage/index.d.ts

@@ -1,21 +1,13 @@
 import type { AFSEntry, AFSModule } from "@aigne/afs";
-import { initDatabase } from "@aigne/sqlite";
 import type { AFSStorage, AFSStorageCreateOptions, AFSStorageCreatePayload, AFSStorageDeleteOptions, AFSStorageListOptions, AFSStorageReadOptions } from "./type.js";
 export * from "./type.js";
-export interface SharedAFSStorageOptions {
+export interface AFSStorageSQLiteOptions {
     url?: string;
 }
-export declare class SharedAFSStorage {
-    options?: SharedAFSStorageOptions | undefined;
-    constructor(options?: SharedAFSStorageOptions | undefined);
-    private _db;
-    get db(): Promise<import("drizzle-orm/sqlite-proxy/driver.js").SqliteRemoteDatabase<Record<string, never>>>;
-    withModule(module: AFSModule): AFSStorage;
-}
-export declare class AFSStorageWithModule implements AFSStorage {
-    private db;
-    private module;
-    constructor(db: ReturnType<typeof initDatabase>, module: AFSModule);
+export declare class AFSStorageSQLite implements AFSStorage {
+    module: AFSModule;
+    options?: AFSStorageSQLiteOptions | undefined;
+    constructor(module: AFSModule, options?: AFSStorageSQLiteOptions | undefined);
     private _tables?;
     private get tables();
     list(options?: AFSStorageListOptions): Promise<{

package/lib/cjs/storage/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AFSStorageWithModule = exports.SharedAFSStorage = void 0;
+exports.AFSStorageSQLite = void 0;
 const sqlite_1 = require("@aigne/sqlite");
 const migrate_js_1 = require("./migrate.js");
 const compact_js_1 = require("./models/compact.js");
@@ -22,32 +22,17 @@ const entries_js_1 = require("./models/entries.js");
 const memory_js_1 = require("./models/memory.js");
 __exportStar(require("./type.js"), exports);
 const DEFAULT_AFS_STORAGE_LIST_LIMIT = 10;
-class SharedAFSStorage {
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    _db;
-    get db() {
-        this._db ??= (0, sqlite_1.initDatabase)({ url: this.options?.url });
-        return this._db;
-    }
-    withModule(module) {
-        return new AFSStorageWithModule(this.db, module);
-    }
-}
-exports.SharedAFSStorage = SharedAFSStorage;
-class AFSStorageWithModule {
-    db;
+class AFSStorageSQLite {
     module;
-    constructor(db, module) {
-        this.db = db;
+    options;
+    constructor(module, options) {
         this.module = module;
+        this.options = options;
     }
     _tables;
     get tables() {
         if (!this._tables) {
-            this._tables = this.db.then((db) => (0, migrate_js_1.migrate)(db, this.module).then(() => ({
+            this._tables = (0, sqlite_1.initDatabase)({ url: this.options?.url }).then((db) => (0, migrate_js_1.migrate)(db, this.module).then(() => ({
                 db,
                 entries: (0, entries_js_1.entriesTable)(this.module),
                 compact: (0, compact_js_1.compactTable)(this.module),
@@ -130,4 +115,4 @@ class AFSStorageWithModule {
         return { deletedCount: result.length };
     }
 }
-exports.AFSStorageWithModule = AFSStorageWithModule;
+exports.AFSStorageSQLite = AFSStorageSQLite;

package/lib/cjs/storage/type.d.ts

@@ -45,6 +45,7 @@ export interface AFSStorage {
         deletedCount: number;
     }>;
 }
+export declare function isAFSStorage(value: any): value is AFSStorage;
 export type AFSStorageMigrations = {
     hash: string;
     sql: (module: AFSModule) => SQL[];

package/lib/cjs/storage/type.js

@@ -1,2 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAFSStorage = isAFSStorage;
+function isAFSStorage(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        typeof value.create === "function" &&
+        typeof value.list === "function" &&
+        typeof value.read === "function" &&
+        typeof value.delete === "function");
+}

package/lib/dts/index.d.ts

@@ -1,9 +1,9 @@
 import { type AFSAccessMode, type AFSDeleteOptions, type AFSDeleteResult, type AFSListOptions, type AFSListResult, type AFSModule, type AFSModuleLoadParams, type AFSReadOptions, type AFSReadResult, type AFSRoot, type AFSWriteEntryPayload, type AFSWriteOptions, type AFSWriteResult } from "@aigne/afs";
 import { z } from "zod";
-import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
+import { type AFSStorage, type AFSStorageSQLiteOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
-    storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    storage?: AFSStorage | AFSStorageSQLiteOptions;
     /**
      * Access mode for this module.
      * @default "readwrite"
@@ -11,26 +11,19 @@ export interface AFSHistoryOptions {
     accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
-    static schema(): z.ZodObject<{
-        storage: z.ZodOptional<z.ZodObject<{
-            url: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            url?: string | undefined;
-        }, {
-            url?: string | undefined;
-        }>>;
+    static schema(): z.ZodEffects<z.ZodObject<{
+        storage: z.ZodType<any, z.ZodTypeDef, any>;
         accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
     }, "strip", z.ZodTypeAny, {
-        storage?: {
-            url?: string | undefined;
-        } | undefined;
+        storage?: any;
         accessMode?: "readonly" | "readwrite" | undefined;
     }, {
-        storage?: {
-            url?: string | undefined;
-        } | undefined;
+        storage?: any;
         accessMode?: "readonly" | "readwrite" | undefined;
-    }>;
+    }>, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, any>;
     static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;

package/lib/dts/storage/index.d.ts

@@ -1,23 +1,13 @@
 import type { AFSEntry, AFSModule } from "@aigne/afs";
-import { initDatabase } from "@aigne/sqlite";
 import type { AFSStorage, AFSStorageCreateOptions, AFSStorageCreatePayload, AFSStorageDeleteOptions, AFSStorageListOptions, AFSStorageReadOptions } from "./type.js";
 export * from "./type.js";
-export interface SharedAFSStorageOptions {
+export interface AFSStorageSQLiteOptions {
     url?: string;
 }
-export declare class SharedAFSStorage {
-    options?: SharedAFSStorageOptions | undefined;
-    constructor(options?: SharedAFSStorageOptions | undefined);
-    private _db;
-    get db(): Promise<import("drizzle-orm/libsql").LibSQLDatabase<Record<string, never>> & {
-        vacuum?: () => Promise<void>;
-    }>;
-    withModule(module: AFSModule): AFSStorage;
-}
-export declare class AFSStorageWithModule implements AFSStorage {
-    private db;
-    private module;
-    constructor(db: ReturnType<typeof initDatabase>, module: AFSModule);
+export declare class AFSStorageSQLite implements AFSStorage {
+    module: AFSModule;
+    options?: AFSStorageSQLiteOptions | undefined;
+    constructor(module: AFSModule, options?: AFSStorageSQLiteOptions | undefined);
     private _tables?;
     private get tables();
     list(options?: AFSStorageListOptions): Promise<{

package/lib/dts/storage/type.d.ts

@@ -45,6 +45,7 @@ export interface AFSStorage {
         deletedCount: number;
     }>;
 }
+export declare function isAFSStorage(value: any): value is AFSStorage;
 export type AFSStorageMigrations = {
     hash: string;
     sql: (module: AFSModule) => SQL[];

package/lib/esm/index.d.ts

@@ -1,9 +1,9 @@
 import { type AFSAccessMode, type AFSDeleteOptions, type AFSDeleteResult, type AFSListOptions, type AFSListResult, type AFSModule, type AFSModuleLoadParams, type AFSReadOptions, type AFSReadResult, type AFSRoot, type AFSWriteEntryPayload, type AFSWriteOptions, type AFSWriteResult } from "@aigne/afs";
 import { z } from "zod";
-import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
+import { type AFSStorage, type AFSStorageSQLiteOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
-    storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    storage?: AFSStorage | AFSStorageSQLiteOptions;
     /**
      * Access mode for this module.
      * @default "readwrite"
@@ -11,26 +11,19 @@ export interface AFSHistoryOptions {
     accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
-    static schema(): z.ZodObject<{
-        storage: z.ZodOptional<z.ZodObject<{
-            url: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            url?: string | undefined;
-        }, {
-            url?: string | undefined;
-        }>>;
+    static schema(): z.ZodEffects<z.ZodObject<{
+        storage: z.ZodType<any, z.ZodTypeDef, any>;
         accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
     }, "strip", z.ZodTypeAny, {
-        storage?: {
-            url?: string | undefined;
-        } | undefined;
+        storage?: any;
         accessMode?: "readonly" | "readwrite" | undefined;
     }, {
-        storage?: {
-            url?: string | undefined;
-        } | undefined;
+        storage?: any;
         accessMode?: "readonly" | "readwrite" | undefined;
-    }>;
+    }>, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, any>;
     static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;

package/lib/esm/index.js

@@ -1,20 +1,16 @@
 import { accessModeSchema, } from "@aigne/afs";
+import { camelize, optionalize, zodParse } from "@aigne/afs-utils/zod/index.js";
 import { v7 } from "@aigne/uuid";
 import { createRouter } from "radix3";
 import { joinURL } from "ufo";
 import { z } from "zod";
-import { SharedAFSStorage, } from "./storage/index.js";
+import { AFSStorageSQLite, isAFSStorage, } from "./storage/index.js";
 export * from "./storage/index.js";
-const sharedAFSStorageOptionsSchema = z.object({
-    url: z.string().describe("Database URL for storage").optional(),
-});
-const afsHistoryOptionsSchema = preprocessSchema((v) => {
-    if (!v || typeof v !== "object") {
-        return v;
-    }
-    return { ...v, accessMode: v.accessMode || v.access_mode };
-}, z.object({
-    storage: sharedAFSStorageOptionsSchema.optional(),
+const afsStorageOptionsSchema = camelize(z.object({
+    url: optionalize(z.string().describe("Database URL for storage")),
+}));
+const afsHistoryOptionsSchema = camelize(z.object({
+    storage: optionalize(z.union([z.custom((v) => isAFSStorage(v)), afsStorageOptionsSchema])),
     accessMode: accessModeSchema,
 }));
 export class AFSHistory {
@@ -26,10 +22,10 @@ export class AFSHistory {
         return new AFSHistory(valid);
     }
     constructor(options) {
-        this.storage =
-            options?.storage instanceof SharedAFSStorage
-                ? options.storage.withModule(this)
-                : new SharedAFSStorage(options?.storage).withModule(this);
+        zodParse(optionalize(afsHistoryOptionsSchema), options);
+        this.storage = isAFSStorage(options?.storage)
+            ? options.storage
+            : new AFSStorageSQLite(this, options?.storage);
         this.accessMode = options?.accessMode ?? "readwrite";
     }
     name = "history";
@@ -258,6 +254,3 @@ export class AFSHistory {
     }
 }
 const _typeCheck = AFSHistory;
-function preprocessSchema(fn, schema) {
-    return z.preprocess(fn, schema);
-}

package/lib/esm/storage/index.d.ts

@@ -1,23 +1,13 @@
 import type { AFSEntry, AFSModule } from "@aigne/afs";
-import { initDatabase } from "@aigne/sqlite";
 import type { AFSStorage, AFSStorageCreateOptions, AFSStorageCreatePayload, AFSStorageDeleteOptions, AFSStorageListOptions, AFSStorageReadOptions } from "./type.js";
 export * from "./type.js";
-export interface SharedAFSStorageOptions {
+export interface AFSStorageSQLiteOptions {
     url?: string;
 }
-export declare class SharedAFSStorage {
-    options?: SharedAFSStorageOptions | undefined;
-    constructor(options?: SharedAFSStorageOptions | undefined);
-    private _db;
-    get db(): Promise<import("drizzle-orm/libsql").LibSQLDatabase<Record<string, never>> & {
-        vacuum?: () => Promise<void>;
-    }>;
-    withModule(module: AFSModule): AFSStorage;
-}
-export declare class AFSStorageWithModule implements AFSStorage {
-    private db;
-    private module;
-    constructor(db: ReturnType<typeof initDatabase>, module: AFSModule);
+export declare class AFSStorageSQLite implements AFSStorage {
+    module: AFSModule;
+    options?: AFSStorageSQLiteOptions | undefined;
+    constructor(module: AFSModule, options?: AFSStorageSQLiteOptions | undefined);
     private _tables?;
     private get tables();
     list(options?: AFSStorageListOptions): Promise<{

package/lib/esm/storage/index.js

@@ -5,31 +5,17 @@ import { entriesTable } from "./models/entries.js";
 import { memoryTable } from "./models/memory.js";
 export * from "./type.js";
 const DEFAULT_AFS_STORAGE_LIST_LIMIT = 10;
-export class SharedAFSStorage {
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    _db;
-    get db() {
-        this._db ??= initDatabase({ url: this.options?.url });
-        return this._db;
-    }
-    withModule(module) {
-        return new AFSStorageWithModule(this.db, module);
-    }
-}
-export class AFSStorageWithModule {
-    db;
+export class AFSStorageSQLite {
     module;
-    constructor(db, module) {
-        this.db = db;
+    options;
+    constructor(module, options) {
         this.module = module;
+        this.options = options;
     }
     _tables;
     get tables() {
         if (!this._tables) {
-            this._tables = this.db.then((db) => migrate(db, this.module).then(() => ({
+            this._tables = initDatabase({ url: this.options?.url }).then((db) => migrate(db, this.module).then(() => ({
                 db,
                 entries: entriesTable(this.module),
                 compact: compactTable(this.module),

package/lib/esm/storage/type.d.ts

@@ -45,6 +45,7 @@ export interface AFSStorage {
         deletedCount: number;
     }>;
 }
+export declare function isAFSStorage(value: any): value is AFSStorage;
 export type AFSStorageMigrations = {
     hash: string;
     sql: (module: AFSModule) => SQL[];

package/lib/esm/storage/type.js

@@ -1 +1,8 @@
-export {};
+export function isAFSStorage(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        typeof value.create === "function" &&
+        typeof value.list === "function" &&
+        typeof value.read === "function" &&
+        typeof value.delete === "function");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/afs-history",
-  "version": "1.2.0",
+  "version": "1.3.0-beta",
   "description": "AIGNE AFS module for managing chat history",
   "publishConfig": {
     "access": "public"
@@ -51,8 +51,9 @@
     "radix3": "^1.1.2",
     "ufo": "^1.6.1",
     "zod": "^3.25.67",
-    "@aigne/afs": "^1.4.0",
-    "@aigne/sqlite": "^0.4.9"
+    "@aigne/sqlite": "^0.4.9",
+    "@aigne/afs-utils": "^1.0.0",
+    "@aigne/afs": "^1.4.0"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",