Introduce Path-based LiveObjects API - merge integration/objects-breaking-api into main

.gitignore

@@ -4,6 +4,7 @@ ably-js.iml
 node_modules
 npm-debug.log
 .tool-versions
+liveobjects.d.mts
 build/
 react/
 typedoc/generated/

Gruntfile.js

@@ -73,7 +73,7 @@ module.exports = function (grunt) {
     });
   });
 
-  grunt.registerTask('build', ['webpack:all', 'build:browser', 'build:node', 'build:push', 'build:objects']);
+  grunt.registerTask('build', ['webpack:all', 'build:browser', 'build:node', 'build:push', 'build:liveobjects']);
 
   grunt.registerTask('all', ['build', 'requirejs']);
 
@@ -138,13 +138,14 @@ module.exports = function (grunt) {
       });
   });
 
-  grunt.registerTask('build:objects', function () {
+  grunt.registerTask('build:liveobjects:bundle', function () {
     var done = this.async();
 
     Promise.all([
-      esbuild.build(esbuildConfig.objectsPluginConfig),
-      esbuild.build(esbuildConfig.objectsPluginCdnConfig),
-      esbuild.build(esbuildConfig.minifiedObjectsPluginCdnConfig),
+      esbuild.build(esbuildConfig.liveObjectsPluginConfig),
+      esbuild.build(esbuildConfig.liveObjectsPluginEsmConfig),
+      esbuild.build(esbuildConfig.liveObjectsPluginCdnConfig),
+      esbuild.build(esbuildConfig.minifiedLiveObjectsPluginCdnConfig),
     ])
       .then(() => {
         done(true);
@@ -154,10 +155,23 @@ module.exports = function (grunt) {
       });
   });
 
+  grunt.registerTask(
+    'build:liveobjects:types',
+    'Generate liveobjects.d.mts from liveobjects.d.ts by adding .js extensions to relative imports',
+    function () {
+      const dtsContent = fs.readFileSync('liveobjects.d.ts', 'utf8');
+      const mtsContent = dtsContent.replace(/from '(\.\/[^']+)'/g, "from '$1.js'");
+      fs.writeFileSync('liveobjects.d.mts', mtsContent);
+      grunt.log.ok('Generated liveobjects.d.mts from liveobjects.d.ts');
+    },
+  );
+
+  grunt.registerTask('build:liveobjects', ['build:liveobjects:bundle', 'build:liveobjects:types']);
+
   grunt.registerTask('test:webserver', 'Launch the Mocha test web server on http://localhost:3000/', [
     'build:browser',
     'build:push',
-    'build:objects',
+    'build:liveobjects',
     'checkGitSubmodules',
     'mocha:webserver',
   ]);