@aigne/afs-sqlite 1.11.0-beta → 1.11.0-beta.2

package/LICENSE.md

@@ -1,93 +1,26 @@
-Elastic License 2.0
+# Proprietary License
 
-URL: https://www.elastic.co/licensing/elastic-license
+Copyright (c) 2024-2025 ArcBlock, Inc. All Rights Reserved.
 
-## Acceptance
+This software and associated documentation files (the "Software") are proprietary
+and confidential. Unauthorized copying, modification, distribution, or use of
+this Software, via any medium, is strictly prohibited.
 
-By using the software, you agree to all of the terms and conditions below.
+The Software is provided for internal use only within ArcBlock, Inc. and its
+authorized affiliates.
 
-## Copyright License
+## No License Granted
 
-The licensor grants you a non-exclusive, royalty-free, worldwide,
-non-sublicensable, non-transferable license to use, copy, distribute, make
-available, and prepare derivative works of the software, in each case subject to
-the limitations and conditions below.
+No license, express or implied, is granted to any party for any purpose.
+All rights are reserved by ArcBlock, Inc.
 
-## Limitations
+## Public Artifact Distribution
 
-You may not provide the software to third parties as a hosted or managed
-service, where the service provides users with access to any substantial set of
-the features or functionality of the software.
+Portions of this Software may be released publicly under separate open-source
+licenses (such as MIT License) through designated public repositories. Such
+public releases are governed by their respective licenses and do not affect
+the proprietary nature of this repository.
 
-You may not move, change, disable, or circumvent the license key functionality
-in the software, and you may not remove or obscure any functionality in the
-software that is protected by the license key.
+## Contact
 
-You may not alter, remove, or obscure any licensing, copyright, or other notices
-of the licensor in the software. Any use of the licensor’s trademarks is subject
-to applicable law.
-
-## Patents
-
-The licensor grants you a license, under any patent claims the licensor can
-license, or becomes able to license, to make, have made, use, sell, offer for
-sale, import and have imported the software, in each case subject to the
-limitations and conditions in this license. This license does not cover any
-patent claims that you cause to be infringed by modifications or additions to
-the software. If you or your company make any written claim that the software
-infringes or contributes to infringement of any patent, your patent license for
-the software granted under these terms ends immediately. If your company makes
-such a claim, your patent license ends immediately for work on behalf of your
-company.
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of the software from you
-also gets a copy of these terms.
-
-If you modify the software, you must include in any modified copies of the
-software prominent notices stating that you have modified the software.
-
-## No Other Rights
-
-These terms do not imply any licenses other than those expressly granted in
-these terms.
-
-## Termination
-
-If you use the software in violation of these terms, such use is not licensed,
-and your licenses will automatically terminate. If the licensor provides you
-with a notice of your violation, and you cease all violation of this license no
-later than 30 days after you receive that notice, your licenses will be
-reinstated retroactively. However, if you violate these terms after such
-reinstatement, any additional violation of these terms will cause your licenses
-to terminate automatically and permanently.
-
-## No Liability
-
-*As far as the law allows, the software comes as is, without any warranty or
-condition, and the licensor will not be liable to you for any damages arising
-out of these terms or the use or nature of the software, under any kind of
-legal claim.*
-
-## Definitions
-
-The **licensor** is the entity offering these terms, and the **software** is the
-software the licensor makes available under these terms, including any portion
-of it.
-
-**you** refers to the individual or entity agreeing to these terms.
-
-**your company** is any legal entity, sole proprietorship, or other kind of
-organization that you work for, plus all organizations that have control over,
-are under the control of, or are under common control with that
-organization. **control** means ownership of substantially all the assets of an
-entity, or the power to direct its management and policies by vote, contract, or
-otherwise. Control can be direct or indirect.
-
-**your licenses** are all the licenses granted to you for the software under
-these terms.
-
-**use** means anything you do with the software requiring one of your licenses.
-
-**trademark** means trademarks, service marks, and similar rights.
+For licensing inquiries, contact: legal@arcblock.io

package/README.md

@@ -278,15 +278,12 @@ afs:
 
 ## Related Packages
 
-- [@aigne/afs](../core/README.md) - Core AFS package
-- [@aigne/afs-history](../history/README.md) - History tracking module
-- [@aigne/afs-local-fs](../local-fs/README.md) - Local file system module
+- [@aigne/afs](../../packages/core/README.md) - Core AFS package
+- [@aigne/afs-history](../../afs-providers/history/README.md) - History tracking module
+- [@aigne/afs-fs](../fs/README.md) - Local file system module
 - [@aigne/sqlite](../../packages/sqlite/README.md) - SQLite utilities
 
 ## TypeScript Support
 
 This package includes full TypeScript type definitions.
 
-## License
-
-[Elastic-2.0](../../LICENSE.md)

package/dist/actions/built-in.cjs

@@ -0,0 +1,142 @@
+let _aigne_sqlite = require("@aigne/sqlite");
+
+//#region src/actions/built-in.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(_aigne_sqlite.sql.raw(query)).execute();
+}
+/**
+* Executes a raw SQL query (for INSERT, UPDATE, DELETE)
+*/
+async function execRun(db, query) {
+	await db.run(_aigne_sqlite.sql.raw(query)).execute();
+}
+/**
+* Registers built-in actions to the registry
+*/
+function registerBuiltInActions(registry) {
+	registry.register({
+		name: "refresh",
+		description: "Refresh the schema cache for this module",
+		tableLevel: true,
+		rowLevel: false,
+		handler: async (ctx) => {
+			await ctx.module.refreshSchema();
+			return {
+				success: true,
+				message: "Schema refreshed successfully"
+			};
+		}
+	});
+	registry.register({
+		name: "export",
+		description: "Export table data in specified format (json, csv)",
+		tableLevel: true,
+		rowLevel: false,
+		inputSchema: {
+			type: "object",
+			properties: { format: {
+				type: "string",
+				enum: ["json", "csv"],
+				default: "json"
+			} }
+		},
+		handler: async (ctx, params) => {
+			const format = params.format ?? "json";
+			return {
+				success: true,
+				data: await ctx.module.exportTable(ctx.table, format)
+			};
+		}
+	});
+	registry.register({
+		name: "count",
+		description: "Get the total row count for this table",
+		tableLevel: true,
+		rowLevel: false,
+		handler: async (ctx) => {
+			return {
+				success: true,
+				data: { count: (await execAll(ctx.db, `SELECT COUNT(*) as count FROM "${ctx.table}"`))[0]?.count ?? 0 }
+			};
+		}
+	});
+	registry.register({
+		name: "duplicate",
+		description: "Create a copy of this row",
+		tableLevel: false,
+		rowLevel: true,
+		handler: async (ctx) => {
+			if (!ctx.row) return {
+				success: false,
+				message: "Row data not available"
+			};
+			const schema = ctx.schemas.get(ctx.table);
+			if (!schema) return {
+				success: false,
+				message: `Table '${ctx.table}' not found`
+			};
+			const pkColumn = schema.primaryKey[0] ?? "rowid";
+			const rowCopy = { ...ctx.row };
+			delete rowCopy[pkColumn];
+			delete rowCopy.rowid;
+			const columns = Object.keys(rowCopy);
+			const values = columns.map((col) => formatValueForSQL(rowCopy[col]));
+			await execRun(ctx.db, `INSERT INTO "${ctx.table}" (${columns.map((c) => `"${c}"`).join(", ")}) VALUES (${values.join(", ")})`);
+			return {
+				success: true,
+				data: { newId: (await execAll(ctx.db, "SELECT last_insert_rowid() as id"))[0]?.id },
+				message: "Row duplicated successfully"
+			};
+		}
+	});
+	registry.register({
+		name: "validate",
+		description: "Validate row data against schema constraints",
+		tableLevel: false,
+		rowLevel: true,
+		handler: async (ctx) => {
+			if (!ctx.row) return {
+				success: false,
+				message: "Row data not available"
+			};
+			const schema = ctx.schemas.get(ctx.table);
+			if (!schema) return {
+				success: false,
+				message: `Table '${ctx.table}' not found`
+			};
+			const errors = [];
+			for (const col of schema.columns) if (col.notnull && (ctx.row[col.name] === null || ctx.row[col.name] === void 0)) errors.push(`Column '${col.name}' cannot be null`);
+			for (const fk of schema.foreignKeys) {
+				const value = ctx.row[fk.from];
+				if (value !== null && value !== void 0) {
+					if ((await execAll(ctx.db, `SELECT COUNT(*) as count FROM "${fk.table}" WHERE "${fk.to}" = '${String(value).replace(/'/g, "''")}'`))[0]?.count === 0) errors.push(`Foreign key violation: ${fk.from} references non-existent ${fk.table}.${fk.to}`);
+				}
+			}
+			return {
+				success: errors.length === 0,
+				data: {
+					errors,
+					valid: errors.length === 0
+				},
+				message: errors.length > 0 ? `Validation failed: ${errors.join("; ")}` : "Row is valid"
+			};
+		}
+	});
+}
+/**
+* Formats a value for SQL insertion
+*/
+function formatValueForSQL(value) {
+	if (value === null || value === void 0) return "NULL";
+	if (typeof value === "number") return String(value);
+	if (typeof value === "boolean") return value ? "1" : "0";
+	if (value instanceof Date) return `'${value.toISOString()}'`;
+	if (typeof value === "object") return `'${JSON.stringify(value).replace(/'/g, "''")}'`;
+	return `'${String(value).replace(/'/g, "''")}'`;
+}
+
+//#endregion
+exports.registerBuiltInActions = registerBuiltInActions;

package/dist/actions/built-in.d.cts

@@ -0,0 +1,10 @@
+import { ActionsRegistry } from "./registry.cjs";
+
+//#region src/actions/built-in.d.ts
+/**
+ * Registers built-in actions to the registry
+ */
+declare function registerBuiltInActions(registry: ActionsRegistry): void;
+//#endregion
+export { registerBuiltInActions };
+//# sourceMappingURL=built-in.d.cts.map

package/dist/actions/built-in.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.d.cts","names":[],"sources":["../../src/actions/built-in.ts"],"mappings":";;;;AAsBA;;iBAAgB,sBAAA,CAAA,QAAA,EAAiC,eAAA"}

package/dist/actions/built-in.d.mts

@@ -0,0 +1,10 @@
+import { ActionsRegistry } from "./registry.mjs";
+
+//#region src/actions/built-in.d.ts
+/**
+ * Registers built-in actions to the registry
+ */
+declare function registerBuiltInActions(registry: ActionsRegistry): void;
+//#endregion
+export { registerBuiltInActions };
+//# sourceMappingURL=built-in.d.mts.map

package/dist/actions/built-in.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.d.mts","names":[],"sources":["../../src/actions/built-in.ts"],"mappings":";;;;AAsBA;;iBAAgB,sBAAA,CAAA,QAAA,EAAiC,eAAA"}

package/dist/actions/built-in.mjs

@@ -0,0 +1,143 @@
+import { sql } from "@aigne/sqlite";
+
+//#region src/actions/built-in.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(sql.raw(query)).execute();
+}
+/**
+* Executes a raw SQL query (for INSERT, UPDATE, DELETE)
+*/
+async function execRun(db, query) {
+	await db.run(sql.raw(query)).execute();
+}
+/**
+* Registers built-in actions to the registry
+*/
+function registerBuiltInActions(registry) {
+	registry.register({
+		name: "refresh",
+		description: "Refresh the schema cache for this module",
+		tableLevel: true,
+		rowLevel: false,
+		handler: async (ctx) => {
+			await ctx.module.refreshSchema();
+			return {
+				success: true,
+				message: "Schema refreshed successfully"
+			};
+		}
+	});
+	registry.register({
+		name: "export",
+		description: "Export table data in specified format (json, csv)",
+		tableLevel: true,
+		rowLevel: false,
+		inputSchema: {
+			type: "object",
+			properties: { format: {
+				type: "string",
+				enum: ["json", "csv"],
+				default: "json"
+			} }
+		},
+		handler: async (ctx, params) => {
+			const format = params.format ?? "json";
+			return {
+				success: true,
+				data: await ctx.module.exportTable(ctx.table, format)
+			};
+		}
+	});
+	registry.register({
+		name: "count",
+		description: "Get the total row count for this table",
+		tableLevel: true,
+		rowLevel: false,
+		handler: async (ctx) => {
+			return {
+				success: true,
+				data: { count: (await execAll(ctx.db, `SELECT COUNT(*) as count FROM "${ctx.table}"`))[0]?.count ?? 0 }
+			};
+		}
+	});
+	registry.register({
+		name: "duplicate",
+		description: "Create a copy of this row",
+		tableLevel: false,
+		rowLevel: true,
+		handler: async (ctx) => {
+			if (!ctx.row) return {
+				success: false,
+				message: "Row data not available"
+			};
+			const schema = ctx.schemas.get(ctx.table);
+			if (!schema) return {
+				success: false,
+				message: `Table '${ctx.table}' not found`
+			};
+			const pkColumn = schema.primaryKey[0] ?? "rowid";
+			const rowCopy = { ...ctx.row };
+			delete rowCopy[pkColumn];
+			delete rowCopy.rowid;
+			const columns = Object.keys(rowCopy);
+			const values = columns.map((col) => formatValueForSQL(rowCopy[col]));
+			await execRun(ctx.db, `INSERT INTO "${ctx.table}" (${columns.map((c) => `"${c}"`).join(", ")}) VALUES (${values.join(", ")})`);
+			return {
+				success: true,
+				data: { newId: (await execAll(ctx.db, "SELECT last_insert_rowid() as id"))[0]?.id },
+				message: "Row duplicated successfully"
+			};
+		}
+	});
+	registry.register({
+		name: "validate",
+		description: "Validate row data against schema constraints",
+		tableLevel: false,
+		rowLevel: true,
+		handler: async (ctx) => {
+			if (!ctx.row) return {
+				success: false,
+				message: "Row data not available"
+			};
+			const schema = ctx.schemas.get(ctx.table);
+			if (!schema) return {
+				success: false,
+				message: `Table '${ctx.table}' not found`
+			};
+			const errors = [];
+			for (const col of schema.columns) if (col.notnull && (ctx.row[col.name] === null || ctx.row[col.name] === void 0)) errors.push(`Column '${col.name}' cannot be null`);
+			for (const fk of schema.foreignKeys) {
+				const value = ctx.row[fk.from];
+				if (value !== null && value !== void 0) {
+					if ((await execAll(ctx.db, `SELECT COUNT(*) as count FROM "${fk.table}" WHERE "${fk.to}" = '${String(value).replace(/'/g, "''")}'`))[0]?.count === 0) errors.push(`Foreign key violation: ${fk.from} references non-existent ${fk.table}.${fk.to}`);
+				}
+			}
+			return {
+				success: errors.length === 0,
+				data: {
+					errors,
+					valid: errors.length === 0
+				},
+				message: errors.length > 0 ? `Validation failed: ${errors.join("; ")}` : "Row is valid"
+			};
+		}
+	});
+}
+/**
+* Formats a value for SQL insertion
+*/
+function formatValueForSQL(value) {
+	if (value === null || value === void 0) return "NULL";
+	if (typeof value === "number") return String(value);
+	if (typeof value === "boolean") return value ? "1" : "0";
+	if (value instanceof Date) return `'${value.toISOString()}'`;
+	if (typeof value === "object") return `'${JSON.stringify(value).replace(/'/g, "''")}'`;
+	return `'${String(value).replace(/'/g, "''")}'`;
+}
+
+//#endregion
+export { registerBuiltInActions };
+//# sourceMappingURL=built-in.mjs.map

package/dist/actions/built-in.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in.mjs","names":[],"sources":["../../src/actions/built-in.ts"],"sourcesContent":["import { sql } from \"@aigne/sqlite\";\nimport type { LibSQLDatabase } from \"drizzle-orm/libsql\";\nimport type { ActionsRegistry } from \"./registry.js\";\nimport type { ActionContext, ActionResult } from \"./types.js\";\n\n/**\n * Executes a raw SQL query and returns all rows\n */\nasync function execAll<T>(db: LibSQLDatabase, query: string): Promise<T[]> {\n  return db.all<T>(sql.raw(query)).execute();\n}\n\n/**\n * Executes a raw SQL query (for INSERT, UPDATE, DELETE)\n */\nasync function execRun(db: LibSQLDatabase, query: string): Promise<void> {\n  await db.run(sql.raw(query)).execute();\n}\n\n/**\n * Registers built-in actions to the registry\n */\nexport function registerBuiltInActions(registry: ActionsRegistry): void {\n  // Refresh schema action (table level)\n  registry.register({\n    name: \"refresh\",\n    description: \"Refresh the schema cache for this module\",\n    tableLevel: true,\n    rowLevel: false,\n    handler: async (ctx: ActionContext): Promise<ActionResult> => {\n      await ctx.module.refreshSchema();\n      return {\n        success: true,\n        message: \"Schema refreshed successfully\",\n      };\n    },\n  });\n\n  // Export table action (table level)\n  registry.register({\n    name: \"export\",\n    description: \"Export table data in specified format (json, csv)\",\n    tableLevel: true,\n    rowLevel: false,\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        format: {\n          type: \"string\",\n          enum: [\"json\", \"csv\"],\n          default: \"json\",\n        },\n      },\n    },\n    handler: async (ctx: ActionContext, params): Promise<ActionResult> => {\n      const format = (params.format as string) ?? \"json\";\n      const data = await ctx.module.exportTable(ctx.table, format);\n      return {\n        success: true,\n        data,\n      };\n    },\n  });\n\n  // Count rows action (table level)\n  registry.register({\n    name: \"count\",\n    description: \"Get the total row count for this table\",\n    tableLevel: true,\n    rowLevel: false,\n    handler: async (ctx: ActionContext): Promise<ActionResult> => {\n      const result = await execAll<{ count: number }>(\n        ctx.db,\n        `SELECT COUNT(*) as count FROM \"${ctx.table}\"`,\n      );\n      return {\n        success: true,\n        data: { count: result[0]?.count ?? 0 },\n      };\n    },\n  });\n\n  // Duplicate row action (row level)\n  registry.register({\n    name: \"duplicate\",\n    description: \"Create a copy of this row\",\n    tableLevel: false,\n    rowLevel: true,\n    handler: async (ctx: ActionContext): Promise<ActionResult> => {\n      if (!ctx.row) {\n        return { success: false, message: \"Row data not available\" };\n      }\n\n      const schema = ctx.schemas.get(ctx.table);\n      if (!schema) {\n        return { success: false, message: `Table '${ctx.table}' not found` };\n      }\n\n      // Create a copy without the primary key\n      const pkColumn = schema.primaryKey[0] ?? \"rowid\";\n      const rowCopy = { ...ctx.row };\n      delete rowCopy[pkColumn];\n      delete rowCopy.rowid;\n\n      // Build insert query\n      const columns = Object.keys(rowCopy);\n      const values = columns.map((col) => formatValueForSQL(rowCopy[col]));\n\n      await execRun(\n        ctx.db,\n        `INSERT INTO \"${ctx.table}\" (${columns.map((c) => `\"${c}\"`).join(\", \")}) VALUES (${values.join(\", \")})`,\n      );\n\n      // Get the new row's ID\n      const lastIdResult = await execAll<{ id: number }>(\n        ctx.db,\n        \"SELECT last_insert_rowid() as id\",\n      );\n\n      return {\n        success: true,\n        data: { newId: lastIdResult[0]?.id },\n        message: \"Row duplicated successfully\",\n      };\n    },\n  });\n\n  // Validate row action (row level)\n  registry.register({\n    name: \"validate\",\n    description: \"Validate row data against schema constraints\",\n    tableLevel: false,\n    rowLevel: true,\n    handler: async (ctx: ActionContext): Promise<ActionResult> => {\n      if (!ctx.row) {\n        return { success: false, message: \"Row data not available\" };\n      }\n\n      const schema = ctx.schemas.get(ctx.table);\n      if (!schema) {\n        return { success: false, message: `Table '${ctx.table}' not found` };\n      }\n\n      const errors: string[] = [];\n\n      // Check NOT NULL constraints\n      for (const col of schema.columns) {\n        if (col.notnull && (ctx.row[col.name] === null || ctx.row[col.name] === undefined)) {\n          errors.push(`Column '${col.name}' cannot be null`);\n        }\n      }\n\n      // Check foreign key references\n      for (const fk of schema.foreignKeys) {\n        const value = ctx.row[fk.from];\n        if (value !== null && value !== undefined) {\n          const refResult = await execAll<{ count: number }>(\n            ctx.db,\n            `SELECT COUNT(*) as count FROM \"${fk.table}\" WHERE \"${fk.to}\" = '${String(value).replace(/'/g, \"''\")}'`,\n          );\n          if (refResult[0]?.count === 0) {\n            errors.push(\n              `Foreign key violation: ${fk.from} references non-existent ${fk.table}.${fk.to}`,\n            );\n          }\n        }\n      }\n\n      return {\n        success: errors.length === 0,\n        data: { errors, valid: errors.length === 0 },\n        message: errors.length > 0 ? `Validation failed: ${errors.join(\"; \")}` : \"Row is valid\",\n      };\n    },\n  });\n}\n\n/**\n * Formats a value for SQL insertion\n */\nfunction formatValueForSQL(value: unknown): string {\n  if (value === null || value === undefined) {\n    return \"NULL\";\n  }\n  if (typeof value === \"number\") {\n    return String(value);\n  }\n  if (typeof value === \"boolean\") {\n    return value ? \"1\" : \"0\";\n  }\n  if (value instanceof Date) {\n    return `'${value.toISOString()}'`;\n  }\n  if (typeof value === \"object\") {\n    return `'${JSON.stringify(value).replace(/'/g, \"''\")}'`;\n  }\n  return `'${String(value).replace(/'/g, \"''\")}'`;\n}\n"],"mappings":"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"}

package/dist/actions/registry.cjs

@@ -0,0 +1,91 @@
+
+//#region src/actions/registry.ts
+/**
+* Registry for managing action handlers
+*/
+var ActionsRegistry = class {
+	handlers = /* @__PURE__ */ new Map();
+	/**
+	* Registers an action handler
+	*/
+	register(definition) {
+		this.handlers.set(definition.name, definition);
+	}
+	/**
+	* Registers a simple action with just name and handler
+	*/
+	registerSimple(name, handler, options) {
+		this.register({
+			name,
+			handler,
+			description: options?.description,
+			tableLevel: options?.tableLevel ?? false,
+			rowLevel: options?.rowLevel ?? true
+		});
+	}
+	/**
+	* Unregisters an action
+	*/
+	unregister(name) {
+		return this.handlers.delete(name);
+	}
+	/**
+	* Checks if an action is registered
+	*/
+	has(name) {
+		return this.handlers.has(name);
+	}
+	/**
+	* Gets an action definition
+	*/
+	get(name) {
+		return this.handlers.get(name);
+	}
+	/**
+	* Lists all registered actions
+	*/
+	list(options) {
+		const actions = Array.from(this.handlers.values());
+		if (options?.tableLevel !== void 0 || options?.rowLevel !== void 0) return actions.filter((a) => {
+			if (options.tableLevel && !a.tableLevel) return false;
+			if (options.rowLevel && !a.rowLevel) return false;
+			return true;
+		});
+		return actions;
+	}
+	/**
+	* Lists action names
+	*/
+	listNames(options) {
+		return this.list(options).map((a) => a.name);
+	}
+	/**
+	* Executes an action
+	*/
+	async execute(name, ctx, params = {}) {
+		const definition = this.handlers.get(name);
+		if (!definition) return {
+			success: false,
+			message: `Unknown action: ${name}`
+		};
+		if (ctx.pk && !definition.rowLevel) return {
+			success: false,
+			message: `Action '${name}' is not available at row level`
+		};
+		if (!ctx.pk && !definition.tableLevel) return {
+			success: false,
+			message: `Action '${name}' is not available at table level`
+		};
+		try {
+			return await definition.handler(ctx, params);
+		} catch (error) {
+			return {
+				success: false,
+				message: error instanceof Error ? error.message : String(error)
+			};
+		}
+	}
+};
+
+//#endregion
+exports.ActionsRegistry = ActionsRegistry;

package/dist/actions/registry.d.cts

@@ -0,0 +1,54 @@
+import { ActionContext, ActionDefinition, ActionHandler, ActionResult } from "./types.cjs";
+
+//#region src/actions/registry.d.ts
+/**
+ * Registry for managing action handlers
+ */
+declare class ActionsRegistry {
+  private handlers;
+  /**
+       * Registers an action handler
+       */
+  register(definition: ActionDefinition): void;
+  /**
+       * Registers a simple action with just name and handler
+       */
+  registerSimple(name: string, handler: ActionHandler, options?: {
+    description?: string;
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): void;
+  /**
+       * Unregisters an action
+       */
+  unregister(name: string): boolean;
+  /**
+       * Checks if an action is registered
+       */
+  has(name: string): boolean;
+  /**
+       * Gets an action definition
+       */
+  get(name: string): ActionDefinition | undefined;
+  /**
+       * Lists all registered actions
+       */
+  list(options?: {
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): ActionDefinition[];
+  /**
+       * Lists action names
+       */
+  listNames(options?: {
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): string[];
+  /**
+       * Executes an action
+       */
+  execute(name: string, ctx: ActionContext, params?: Record<string, unknown>): Promise<ActionResult>;
+}
+//#endregion
+export { ActionsRegistry };
+//# sourceMappingURL=registry.d.cts.map

package/dist/actions/registry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.cts","names":[],"sources":["../../src/actions/registry.ts"],"mappings":";;;;AAKA;;cAAa,eAAA;EAAA,QAAA,QAAA;EAAA;;;EAAA,SAAA,UAAA,EAMU,gBAAA;EAAA;;;EAAA,eAAA,IAAA,UAAA,OAAA,EASV,aAAA,EAAA,OAAA;IAAA,WAAA;IAAA,UAAA;IAAA,QAAA;EAAA;EAAA;;;EAAA,WAAA,IAAA;EAAA;;;EAAA,IAAA,IAAA;EAAA;;;EAAA,IAAA,IAAA,WAiCQ,gBAAA;EAAA;;;EAAA,KAAA,OAAA;IAAA,UAAA;IAAA,QAAA;EAAA,IAO2C,gBAAA;EAAA;;;EAAA,UAAA,OAAA;IAAA,UAAA;IAAA,QAAA;EAAA;EAAA;;;EAAA,QAAA,IAAA,UAAA,GAAA,EA0BvD,aAAA,EAAA,MAAA,GACG,MAAA,oBACP,OAAA,CAAQ,YAAA;AAAA"}

package/dist/actions/registry.d.mts

@@ -0,0 +1,54 @@
+import { ActionContext, ActionDefinition, ActionHandler, ActionResult } from "./types.mjs";
+
+//#region src/actions/registry.d.ts
+/**
+ * Registry for managing action handlers
+ */
+declare class ActionsRegistry {
+  private handlers;
+  /**
+       * Registers an action handler
+       */
+  register(definition: ActionDefinition): void;
+  /**
+       * Registers a simple action with just name and handler
+       */
+  registerSimple(name: string, handler: ActionHandler, options?: {
+    description?: string;
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): void;
+  /**
+       * Unregisters an action
+       */
+  unregister(name: string): boolean;
+  /**
+       * Checks if an action is registered
+       */
+  has(name: string): boolean;
+  /**
+       * Gets an action definition
+       */
+  get(name: string): ActionDefinition | undefined;
+  /**
+       * Lists all registered actions
+       */
+  list(options?: {
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): ActionDefinition[];
+  /**
+       * Lists action names
+       */
+  listNames(options?: {
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): string[];
+  /**
+       * Executes an action
+       */
+  execute(name: string, ctx: ActionContext, params?: Record<string, unknown>): Promise<ActionResult>;
+}
+//#endregion
+export { ActionsRegistry };
+//# sourceMappingURL=registry.d.mts.map

package/dist/actions/registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","names":[],"sources":["../../src/actions/registry.ts"],"mappings":";;;;AAKA;;cAAa,eAAA;EAAA,QAAA,QAAA;EAAA;;;EAAA,SAAA,UAAA,EAMU,gBAAA;EAAA;;;EAAA,eAAA,IAAA,UAAA,OAAA,EASV,aAAA,EAAA,OAAA;IAAA,WAAA;IAAA,UAAA;IAAA,QAAA;EAAA;EAAA;;;EAAA,WAAA,IAAA;EAAA;;;EAAA,IAAA,IAAA;EAAA;;;EAAA,IAAA,IAAA,WAiCQ,gBAAA;EAAA;;;EAAA,KAAA,OAAA;IAAA,UAAA;IAAA,QAAA;EAAA,IAO2C,gBAAA;EAAA;;;EAAA,UAAA,OAAA;IAAA,UAAA;IAAA,QAAA;EAAA;EAAA;;;EAAA,QAAA,IAAA,UAAA,GAAA,EA0BvD,aAAA,EAAA,MAAA,GACG,MAAA,oBACP,OAAA,CAAQ,YAAA;AAAA"}