@objectstack/objectql 9.7.0 → 9.8.0

package/dist/index.mjs

@@ -2773,6 +2773,13 @@ function normaliseVersionToken(v) {
   }
   return s;
 }
+var CLONE_STRIP_FIELDS = [
+  "id",
+  "created_at",
+  "created_by",
+  "updated_at",
+  "updated_by"
+];
 var SERVICE_CONFIG = {
   auth: { route: "/api/v1/auth", plugin: "plugin-auth" },
   automation: { route: "/api/v1/automation", plugin: "plugin-automation" },
@@ -4028,6 +4035,68 @@ var _ObjectStackProtocolImplementation = class _ObjectStackProtocolImplementatio
       record: result
     };
   }
+  /**
+   * Clone a record — read the source, drop engine-owned columns, and
+   * insert a fresh copy. Gated by the object's `enable.clone` capability
+   * (default `true`; only an explicit `enable.clone === false` disables it).
+   *
+   * Shallow by design: it duplicates the record's own scalar/business field
+   * values, not its related child records. The insert path re-stamps audit
+   * columns, regenerates `autonumber` fields, and recomputes derived
+   * (`formula`/`summary`) fields, so the copy is a valid new row rather than
+   * a byte-identical twin. Caller-supplied `overrides` are applied last and
+   * win over the copied values — the natural place to set a new `name`,
+   * clear a unique field, or reset status before insert.
+   */
+  async cloneData(request) {
+    const schema = this.engine.registry.getObject(request.object);
+    if (!schema) {
+      const err = new Error(`Object '${request.object}' not found`);
+      err.code = "OBJECT_NOT_FOUND";
+      err.status = 404;
+      err.object = request.object;
+      throw err;
+    }
+    if (schema.enable?.clone === false) {
+      const err = new Error(`Cloning is disabled for object '${request.object}'`);
+      err.code = "CLONE_DISABLED";
+      err.status = 403;
+      err.object = request.object;
+      throw err;
+    }
+    const ctx = request.context;
+    const ctxOpt = ctx !== void 0 ? { context: ctx } : void 0;
+    const source = await this.engine.findOne(
+      request.object,
+      { where: { id: request.id }, ...ctxOpt }
+    );
+    if (!source) {
+      const err = new Error(`Record ${request.id} not found in ${request.object}`);
+      err.code = "RECORD_NOT_FOUND";
+      err.status = 404;
+      err.object = request.object;
+      throw err;
+    }
+    const data = { ...source };
+    for (const f of CLONE_STRIP_FIELDS) delete data[f];
+    const fields = schema.fields || {};
+    for (const [name, def] of Object.entries(fields)) {
+      if (!def) continue;
+      if (def.system === true || def.type === "autonumber" || def.type === "formula" || def.type === "summary") {
+        delete data[name];
+      }
+    }
+    if (request.overrides && typeof request.overrides === "object") {
+      Object.assign(data, request.overrides);
+    }
+    const result = await this.engine.insert(request.object, data, ctxOpt);
+    return {
+      object: request.object,
+      id: result.id,
+      sourceId: request.id,
+      record: result
+    };
+  }
   async updateData(request) {
     await this.assertVersionMatch(request.object, request.id, request.expectedVersion, request.context);
     const opts = { where: { id: request.id } };
@@ -7222,6 +7291,11 @@ function applyFormulaPlan(plan, records) {
     }
   }
 }
+function mergeReadContext(fromQuery, fromOptions) {
+  if (fromOptions == null) return fromQuery;
+  if (fromQuery == null) return fromOptions;
+  return { ...fromQuery, ...fromOptions };
+}
 function resolveMetadataItemName(key, item) {
   if (!item) return void 0;
   if (item.name) return item.name;
@@ -8535,7 +8609,7 @@ var _ObjectQL = class _ObjectQL {
   // ============================================
   // Data Access Methods (IDataEngine Interface)
   // ============================================
-  async find(object, query) {
+  async find(object, query, options) {
     object = this.resolveObjectName(object);
     this.logger.debug("Find operation starting", { object, query });
     const driver = this.getDriver(object);
@@ -8564,7 +8638,7 @@ var _ObjectQL = class _ObjectQL {
       operation: "find",
       ast,
       options: query,
-      context: query?.context
+      context: mergeReadContext(query?.context, options?.context)
     };
     await this.executeWithMiddleware(opCtx, async () => {
       const hookContext = {
@@ -8596,7 +8670,7 @@ var _ObjectQL = class _ObjectQL {
     });
     return opCtx.result;
   }
-  async findOne(objectName, query) {
+  async findOne(objectName, query, options) {
     objectName = this.resolveObjectName(objectName);
     this.logger.debug("FindOne operation", { objectName });
     const driver = this.getDriver(objectName);
@@ -8619,7 +8693,7 @@ var _ObjectQL = class _ObjectQL {
       operation: "findOne",
       ast,
       options: query,
-      context: query?.context
+      context: mergeReadContext(query?.context, options?.context)
     };
     await this.executeWithMiddleware(opCtx, async () => {
       const findOneOpts = this.buildDriverOptions(opCtx.context);
@@ -8965,14 +9039,14 @@ var _ObjectQL = class _ObjectQL {
     });
     return opCtx.result;
   }
-  async count(object, query) {
+  async count(object, query, options) {
     object = this.resolveObjectName(object);
     const driver = this.getDriver(object);
     const opCtx = {
       object,
       operation: "count",
       options: query,
-      context: query?.context
+      context: mergeReadContext(query?.context, options?.context)
     };
     await this.executeWithMiddleware(opCtx, async () => {
       const countOpts = this.buildDriverOptions(opCtx.context);
@@ -8985,7 +9059,7 @@ var _ObjectQL = class _ObjectQL {
     });
     return opCtx.result;
   }
-  async aggregate(object, query) {
+  async aggregate(object, query, options) {
     object = this.resolveObjectName(object);
     const driver = this.getDriver(object);
     this.logger.debug(`Aggregate on ${object} using ${driver.name}`, query);
@@ -8993,7 +9067,7 @@ var _ObjectQL = class _ObjectQL {
       object,
       operation: "aggregate",
       options: query,
-      context: query?.context
+      context: mergeReadContext(query?.context, options?.context)
     };
     await this.executeWithMiddleware(opCtx, async () => {
       const ast = {