arcy.js 0.0.2 → 0.1.0

package/dist/snippet.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+/* arcy.js — https://arcyai.com */
+
+// src/loader/snippet.ts
+var CDN_BASE = "https://cdn.arcyai.com";
+function buildInstallSnippet({
+  token,
+  cdnBase = CDN_BASE
+}) {
+  return `<script>
+(function(w,d){
+  if(w.arcy)return;
+  var q=[];
+  function push(m,a,r){q.push({method:m,args:a,resolve:r})}
+  var a={q:q};
+  ['init','identify','identifyAnonymous','updateUser'].forEach(function(m){
+    a[m]=function(){var x=arguments;return new Promise(function(r){push(m,[].slice.call(x),r)})}
+  });
+  ['reset','open','close','on'].forEach(function(m){
+    a[m]=function(){var e={method:m,args:[].slice.call(arguments),resolve:function(){}};q.push(e);
+      if(m==='on')return function(){var i=q.indexOf(e);if(i!==-1)q.splice(i,1)}}
+  });
+  w.arcy=a;
+  if(!w.__arcyHistoryPatched){
+    w.__arcyHistoryPatched=1;
+    var fire=function(){try{w.dispatchEvent(new CustomEvent('arcy:routechange'))}catch(e){}};
+    ['pushState','replaceState'].forEach(function(m){
+      var o=w.history[m];
+      if(typeof o==='function')w.history[m]=function(){var v=o.apply(this,arguments);fire();return v}
+    });
+    w.addEventListener('popstate',fire);
+  }
+  var s=d.createElement('script');
+  s.async=1;
+  s.src='${cdnBase}/arcy.loader.js';
+  s.onerror=function(){console&&console.warn&&console.warn('[arcy] Failed to load. ARCY is disabled.')};
+  var f=d.getElementsByTagName('script')[0];
+  f&&f.parentNode?f.parentNode.insertBefore(s,f):(d.head||d.documentElement).appendChild(s);
+  a.init('${token}');
+})(window,document);
+<\/script>`;
+}
+
+exports.CDN_BASE = CDN_BASE;
+exports.buildInstallSnippet = buildInstallSnippet;

package/dist/snippet.d.cts

@@ -0,0 +1,39 @@
+/**
+ * The HTML install snippet (PRODUCT_SCOPE.md §1.2, ADR 0051).
+ *
+ * This is the exact text a customer pastes before `</body>`, and slice 5.2
+ * renders it on the Installation page with the environment's Token injected.
+ *
+ * **It is frozen at paste time.** Everything here is unfixable for anyone who
+ * has already installed, which is why it is this small and why it contains no
+ * version, no browser list, and no product logic. All of that lives in the
+ * fetched script, where it can be changed for every existing install at once.
+ */
+/** Unversioned on purpose: see ADR 0051. Pinning would freeze every install. */
+declare const CDN_BASE = "https://cdn.arcyai.com";
+interface SnippetOptions {
+    /** The environment Token. Public by construction; it ships in page source. */
+    token: string;
+    /** Overrides the CDN origin. For local development and tests only. */
+    cdnBase?: string;
+}
+/**
+ * Builds the paste-ready `<script>` block.
+ *
+ * The minified body, expanded:
+ *
+ * 1. Bail out if `window.arcy` already exists, so a snippet pasted twice (very
+ *    common with tag managers) does not clobber a live queue.
+ * 2. Create the stub, queueing every public method so `arcy.init()` on the very
+ *    next line works before the script has downloaded.
+ * 3. Patch `pushState`/`replaceState` and announce navigations as a DOM event.
+ * 4. Inject `arcy.loader.js` (ADR 0119), unhashed and revalidated on every
+ *    load, which itself does the ES-modules probe and injects the real,
+ *    content-hashed core bundle. This snippet never names `arcy.modern.js` /
+ *    `arcy.legacy.js` directly, so it never needs to change again once a
+ *    customer has pasted it (ADR 0051).
+ * 5. Call `init` with the token, which queues like any other call.
+ */
+declare function buildInstallSnippet({ token, cdnBase, }: SnippetOptions): string;
+
+export { CDN_BASE, type SnippetOptions, buildInstallSnippet };

package/dist/snippet.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The HTML install snippet (PRODUCT_SCOPE.md §1.2, ADR 0051).
+ *
+ * This is the exact text a customer pastes before `</body>`, and slice 5.2
+ * renders it on the Installation page with the environment's Token injected.
+ *
+ * **It is frozen at paste time.** Everything here is unfixable for anyone who
+ * has already installed, which is why it is this small and why it contains no
+ * version, no browser list, and no product logic. All of that lives in the
+ * fetched script, where it can be changed for every existing install at once.
+ */
+/** Unversioned on purpose: see ADR 0051. Pinning would freeze every install. */
+declare const CDN_BASE = "https://cdn.arcyai.com";
+interface SnippetOptions {
+    /** The environment Token. Public by construction; it ships in page source. */
+    token: string;
+    /** Overrides the CDN origin. For local development and tests only. */
+    cdnBase?: string;
+}
+/**
+ * Builds the paste-ready `<script>` block.
+ *
+ * The minified body, expanded:
+ *
+ * 1. Bail out if `window.arcy` already exists, so a snippet pasted twice (very
+ *    common with tag managers) does not clobber a live queue.
+ * 2. Create the stub, queueing every public method so `arcy.init()` on the very
+ *    next line works before the script has downloaded.
+ * 3. Patch `pushState`/`replaceState` and announce navigations as a DOM event.
+ * 4. Inject `arcy.loader.js` (ADR 0119), unhashed and revalidated on every
+ *    load, which itself does the ES-modules probe and injects the real,
+ *    content-hashed core bundle. This snippet never names `arcy.modern.js` /
+ *    `arcy.legacy.js` directly, so it never needs to change again once a
+ *    customer has pasted it (ADR 0051).
+ * 5. Call `init` with the token, which queues like any other call.
+ */
+declare function buildInstallSnippet({ token, cdnBase, }: SnippetOptions): string;
+
+export { CDN_BASE, type SnippetOptions, buildInstallSnippet };

package/dist/snippet.js

@@ -0,0 +1,43 @@
+/* arcy.js — https://arcyai.com */
+
+// src/loader/snippet.ts
+var CDN_BASE = "https://cdn.arcyai.com";
+function buildInstallSnippet({
+  token,
+  cdnBase = CDN_BASE
+}) {
+  return `<script>
+(function(w,d){
+  if(w.arcy)return;
+  var q=[];
+  function push(m,a,r){q.push({method:m,args:a,resolve:r})}
+  var a={q:q};
+  ['init','identify','identifyAnonymous','updateUser'].forEach(function(m){
+    a[m]=function(){var x=arguments;return new Promise(function(r){push(m,[].slice.call(x),r)})}
+  });
+  ['reset','open','close','on'].forEach(function(m){
+    a[m]=function(){var e={method:m,args:[].slice.call(arguments),resolve:function(){}};q.push(e);
+      if(m==='on')return function(){var i=q.indexOf(e);if(i!==-1)q.splice(i,1)}}
+  });
+  w.arcy=a;
+  if(!w.__arcyHistoryPatched){
+    w.__arcyHistoryPatched=1;
+    var fire=function(){try{w.dispatchEvent(new CustomEvent('arcy:routechange'))}catch(e){}};
+    ['pushState','replaceState'].forEach(function(m){
+      var o=w.history[m];
+      if(typeof o==='function')w.history[m]=function(){var v=o.apply(this,arguments);fire();return v}
+    });
+    w.addEventListener('popstate',fire);
+  }
+  var s=d.createElement('script');
+  s.async=1;
+  s.src='${cdnBase}/arcy.loader.js';
+  s.onerror=function(){console&&console.warn&&console.warn('[arcy] Failed to load. ARCY is disabled.')};
+  var f=d.getElementsByTagName('script')[0];
+  f&&f.parentNode?f.parentNode.insertBefore(s,f):(d.head||d.documentElement).appendChild(s);
+  a.init('${token}');
+})(window,document);
+<\/script>`;
+}
+
+export { CDN_BASE, buildInstallSnippet };

package/package.json

@@ -1,13 +1,77 @@
 {
   "name": "arcy.js",
-  "version": "0.0.2",
-  "description": "ARCY — the universal JavaScript utility for embedding an AI agent that talks to, learns from, and acts on behalf of your users. Coming soon.",
+  "version": "0.1.0",
+  "description": "ARCY — the universal JavaScript utility for embedding an AI agent that talks to, learns from, and acts on behalf of your users.",
   "license": "MIT",
   "type": "module",
-  "main": "./index.js",
   "private": false,
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./snippet": {
+      "source": "./src/loader/snippet.ts",
+      "types": "./dist/snippet.d.ts",
+      "import": "./dist/snippet.js",
+      "require": "./dist/snippet.cjs"
+    },
+    "./design-mode": {
+      "source": "./src/picker/message.ts",
+      "types": "./dist/design-mode.d.ts",
+      "import": "./dist/design-mode.js",
+      "require": "./dist/design-mode.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs && node scripts/size-check.mjs",
+    "dev": "tsup --watch",
+    "size": "node scripts/size-check.mjs",
+    "size:update": "node scripts/size-check.mjs --update",
+    "lint": "eslint",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "devDependencies": {
+    "@workspace/eslint-config": "workspace:*",
+    "@workspace/typescript-config": "workspace:*",
+    "jsdom": "^29.1.1",
+    "modern-screenshot": "4.7.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "homepage": "https://arcyai.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arcy-ai/arcy-ai-frontend-monorepo.git",
+    "directory": "packages/arcy.js"
   },
-  "homepage": "https://arcyai.com"
+  "keywords": [
+    "arcy",
+    "ai",
+    "agent",
+    "widget",
+    "onboarding",
+    "product-adoption"
+  ]
 }

package/index.js

@@ -1,5 +0,0 @@
-// arcy.js — coming soon.
-// This name is reserved by ARCY (https://arcyai.com) for the universal
-// JavaScript utility currently in development. Not yet ready for use.
-
-export {};