@oneie/frontend 0.1.0

package/LICENSE

@@ -0,0 +1,86 @@
+# ONE License (Version 1.0)
+
+Copyright (c) 2024-2026 one.ie
+
+## Maximum Freedom, One Obligation
+
+This license empowers you with complete commercial freedom to use, reuse, modify, sell and resell the software, AI and data, at any price you wish.
+
+No usage limits. No royalty fees. Just pure, unrestricted ability to innovate and profit from the software.
+
+You are free to run ONE locally, on your own servers, in the cloud and at the edge.
+
+## You Receive
+
+### Unlimited Rights
+
+You have unrestricted rights to use, modify, license, sublicense, distribute, sell, resell and monetize the Software without restrictions, subject only to the Brand Requirement below.
+
+### Permitted Actions
+
+Including, but not limited to:
+
+- Commercial use and integration into any systems
+- Creation and sale of derivative works
+- Providing software as a service
+- AI training and content generation
+- Patenting innovations based on the Software
+- Open source applications and integrations
+
+### License Compatibility
+
+This license is compatible with all major open-source licenses, including:
+
+- MIT License
+- Apache License
+- GNU General Public License (GPL)
+- BSD Licenses
+- Mozilla Public License
+
+### Perpetual Rights
+
+These rights are granted in perpetuity and are irrevocable, provided the Brand Requirement is maintained.
+
+## Intellectual Property
+
+- We retain ownership of the original Software and data.
+- You own any modifications you make.
+- You never have to share your code or data.
+
+## Brand Requirement
+
+The only obligation is:
+
+- Don't remove the ONE brand, logo, and link to https://one.ie/ from the deployed product.
+
+To remove the Brand Requirement — white-label, no visible ONE branding — obtain the
+**ONE Enterprise License** (see `LICENSE-ENTERPRISE.md` or contact agent@one.ie).
+
+## Liability and Warranty
+
+The Software and data is provided "AS IS". We bear no liability for its use.
+
+## Termination
+
+This license terminates if you remove or hide the ONE brand, logo, or link without
+holding a current ONE Enterprise License.
+
+## Governing Law and Disputes
+
+This license is governed by the laws of Ireland. The parties will attempt to resolve disputes through good-faith negotiation. If necessary, disputes will proceed to mediation under the Mediators' Institute of Ireland rules, and then to binding arbitration under the Arbitration Act 2010, seated in Dublin, conducted in English.
+
+---
+
+This license is designed to maximize freedom to innovate and profit. There is no copyleft requirement to share any code, making it suitable for enterprise use.
+
+## Enterprise Solutions
+
+Building something big? We're here to help:
+
+- **Free** — use every feature with the ONE brand link in the footer
+- **White-label** — remove the brand requirement (ONE Enterprise License)
+- **Custom** — white-label solutions tailored to your needs
+- **Enterprise** — full support and deployment assistance
+- **Training** — help getting your team started
+
+Contact agent@one.ie to share your needs · Learn at https://one.ie/learn · Agents: https://one.ie/llms.txt

package/README.md

@@ -0,0 +1,21 @@
+# @oneie/frontend
+
+The single config surface for ONE-connected Astro sites.
+
+```ts
+import { defineOne } from '@oneie/frontend'
+
+export default defineOne({
+  backend: { baseUrl: 'https://one.ie' },
+  brand: { tokens: { primary: 'hsl(216 55% 25%)' } },
+  plugins: [auth(), chat({ agent: 'my-bot' })],
+})
+```
+
+`defineOne()` composes each plugin into a single Astro integration and applies the brand tokens globally. All wiring — script injection, Cloudflare bindings, layout wrapping — happens here.
+
+## Exports
+
+- `defineOne(config)` — build the Astro integration
+- `OnePlugin` — plugin type contract
+- `OnePluginFactory<T>` — factory type for authoring plugins

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@oneie/frontend",
+  "version": "0.1.0",
+  "description": "defineOne() + OnePlugin contract — the single config surface for ONE-connected Astro sites",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "peerDependencies": {
+    "astro": ">=6.0.0",
+    "zod": ">=3.0.0"
+  },
+  "devDependencies": {
+    "astro": "^6.2.2",
+    "zod": "^4.4.2",
+    "typescript": "^5.7.3"
+  }
+}

package/src/config.ts

@@ -0,0 +1,70 @@
+import type { AstroIntegration } from 'astro'
+import type { OnePlugin } from './plugin'
+import { virtualOneConfig } from './virtual'
+
+export interface BrandTokens {
+  primary?: string
+  secondary?: string
+  tertiary?: string
+  background?: string
+  foreground?: string
+  font?: string
+}
+
+export interface OneConfig {
+  backend?: {
+    baseUrl?: string
+    apiKey?: string
+  }
+  brand?: {
+    tokens?: BrandTokens
+  }
+  // OnePlugin<any> — a plugins array is heterogeneous; each plugin carries its
+  // own config type (C appears contravariantly in `integration`), so a concrete
+  // OnePlugin<FooConfig> is not assignable to OnePlugin<unknown>. `any` lets the
+  // array hold differently-typed plugins without widening the plugin contract.
+  plugins?: OnePlugin<any>[]
+}
+
+/**
+ * defineOne — the single control surface for a ONE-connected Astro site.
+ *
+ * Returns a composed Astro integration that:
+ *   - Merges each plugin's AstroIntegration into the build (build-time wiring only)
+ *   - Exposes resolved config to islands via the `one:config` virtual module
+ *   - Validates each plugin's config slice at startup
+ *
+ * NOTE: declaring a `paid` plugin here registers its build-time integration but
+ * does NOT grant backend access. The product API returns 402 until the workspace
+ * has an entitlement row (purchased via `one plugin add <name>`).
+ *
+ * Usage in astro.config.mjs:
+ *   import oneIntegration from './one.config.ts'
+ *   export default defineConfig({ integrations: [react(), oneIntegration] })
+ */
+export function defineOne(config: OneConfig): AstroIntegration {
+  return {
+    name: '@oneie/frontend',
+    hooks: {
+      'astro:config:setup': ({ updateConfig, logger }) => {
+        const plugins = config.plugins ?? []
+
+        // Validate each plugin's config slice
+        for (const plugin of plugins) {
+          if (plugin.config) {
+            logger.debug(`[one] validating plugin: ${plugin.name}`)
+          }
+        }
+
+        // Expose resolved config as virtual module
+        updateConfig({
+          vite: {
+            plugins: [virtualOneConfig(config)],
+          },
+        })
+
+        logger.debug(`[one] ${plugins.length} plugin(s) registered`)
+      },
+    },
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { defineOne } from './config'
+export type { OneConfig, BrandTokens } from './config'
+export type { OnePlugin, OnePluginFactory } from './plugin'

package/src/plugin.ts

@@ -0,0 +1,22 @@
+import type { AstroIntegration } from 'astro'
+import type { ZodType } from 'zod'
+
+/**
+ * A ONE plugin — the build-time contract every plugin satisfies.
+ *
+ * `tier` determines what the plugin ships:
+ *   free      — integration only, source in repo, no key needed
+ *   connected — integration injects a served <script> tag (chat/track); needs a workspace key
+ *   paid      — entitlement + serves: backend returns 402 without the claim; UI loads from one.ie
+ */
+export interface OnePlugin<C = unknown> {
+  name: string
+  tier: 'free' | 'connected' | 'paid'
+  config?: ZodType<C>
+  integration?: (config: C) => AstroIntegration
+  entitlement?: string
+  serves?: string
+}
+
+/** Factory function type — plugins export a function that returns OnePlugin */
+export type OnePluginFactory<C = unknown> = (config?: Partial<C>) => OnePlugin<C>

package/src/virtual.ts

@@ -0,0 +1,32 @@
+import type { OneConfig } from './config'
+
+const VIRTUAL_ID = 'one:config'
+const RESOLVED_ID = '\0one:config'
+
+/** Vite plugin that exposes resolved OneConfig as a virtual module `one:config`. */
+export function virtualOneConfig(config: OneConfig) {
+  const resolved = JSON.stringify({
+    backend: {
+      baseUrl: config.backend?.baseUrl ?? 'https://one.ie',
+      hasApiKey: Boolean(config.backend?.apiKey),
+    },
+    brand: config.brand ?? {},
+    plugins: (config.plugins ?? []).map((p) => ({
+      name: p.name,
+      tier: p.tier,
+      entitlement: p.entitlement,
+      serves: p.serves,
+    })),
+  })
+
+  return {
+    name: 'vite-plugin-one-config',
+    resolveId(id: string): string | undefined {
+      if (id === VIRTUAL_ID) return RESOLVED_ID
+    },
+    load(id: string): string | undefined {
+      if (id !== RESOLVED_ID) return
+      return `export default ${resolved}`
+    },
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "noEmit": true
+  },
+  "include": ["src"]
+}