emdash-plugin-relink 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## 0.2.2 — 2026-09-10
+
+- Show the original URL for every history event, with a keyboard-accessible action to open link details.
+- Correct history pagination so legacy events receive the matching target metadata. Preserve original URLs in new history records without requiring a migration.
+- Label replacement destinations separately and localize event counts in English and German.
+- Prepare package metadata and installation guidance for the first npm release.
+
+## 0.2.1 — 2026-09-10
+
+- Support explicit content route aliases, including trailing-slash and legacy article routes, without duplicating link occurrences.
+- Revalidate publication and source links when rendering through an alias.
+- Update the development and isolated-install TOML dependency to the patched release.
+
+## 0.2.0 — 2026-09-10
+
+- Introduce the Relink Noncommercial License 1.0 for otherwise unlicensed additions and changes, with free noncommercial use and separate commercial agreements through gekko mbH.
+- Preserve the original 0.1.0 MIT notice and all existing permissions in the MIT baseline. This transition does not retroactively restrict commercial use of that material.
+- Add commercial-licensing guidance, a contribution-rights policy, and third-party licensing notices.
+- Update release metadata to distinguish the licensing transition from the MIT release. No link-maintenance functionality changes.
+
+## 0.1.0 — 2026-09-10
+
+- Initial native EmDash 0.37.0 plugin and Astro output integration.
+- Published-link indexing, shared checks, persistent scheduling and review history.
+- Verified Wayback recovery and optional conservative Grokipedia matching.
+- Manual destinations, exclusions and persistent undo exceptions.
+- English/German admin pages, dashboard/editor extensions and scoped RTL settings.
+- Strict TypeScript declarations, runtime validation, SQLite/D1 tests and installation examples.
+
+This version is built and distributed from the source repository. npm publication and production deployment are separate release steps.

package/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to Relink
+
+Relink combines free noncommercial availability with separately negotiated commercial licensing by gekko. Contributions must preserve the rights required for both models.
+
+Bug reports and suggestions are welcome. Before submitting code, documentation, translations, or other copyrightable material for inclusion, contact [info2504@gekko.de](mailto:info2504@gekko.de) to arrange a contributor agreement. Do not include material you are not authorized to contribute.
+
+## Required rights before acceptance
+
+A separate agreement must identify the contributor and covered material, confirm the contributor's authority, and grant gekko sufficient enduring rights to use, modify, distribute, sublicense, and commercially license that material under present and future licensing models. It should address relevant patent rights and any employer or third-party approvals. The contributor need not transfer ownership if an appropriate license provides the required rights.
+
+This file is a contribution policy, not a contributor license agreement. Merely opening a pull request, checking a box, or providing a DCO sign-off does not substitute for that agreement. Maintainers must verify and retain the applicable rights agreement before merging external contributions. Do not publish personal or confidential contract details in a public issue or pull request.
+
+## Technical requirements
+
+- Write documentation, comments, and release notes in English.
+- Keep English and German catalogs complete and follow the [translation and RTL guidance](docs/translations.md).
+- Preserve strict TypeScript and runtime validation at trust boundaries.
+- Include relevant behavioral tests and run `pnpm check`.
+- Preserve legacy MIT and third-party notices; identify imported material and its license.
+
+The contribution policy does not revoke anyone's rights in previously MIT-licensed material or rights independently held under applicable law.

package/LICENSE

@@ -0,0 +1,167 @@
+RELINK NONCOMMERCIAL LICENSE 1.0
+
+Copyright (c) 2026 gekko, Gesellschaft für Kommunikation und Kooperation mbH.
+All rights reserved except as expressly granted below or under a separate license.
+
+Licensor: gekko, Gesellschaft für Kommunikation und Kooperation mbH ("gekko")
+Pappelallee 78/79, 10437 Berlin, Germany
+Registration number: HRB 141428 B
+Commercial licensing: info2504@gekko.de
+Website: https://gekko.de
+
+1. Scope and existing rights
+
+This license applies to Relink software, source code, compiled code, examples,
+and documentation that gekko identifies as subject to these terms (the
+"Software"), only to the extent gekko owns or controls the relevant rights.
+"You" means the person or legal entity exercising rights under this license.
+
+Relink 0.1.0, including repository history through commit
+cd88fcc95999976d3744b64331bbf657975328c2, was released under the MIT License.
+The applicable notice is retained in LICENSES/MIT-legacy.txt. These terms do
+not revoke, narrow, or replace rights already granted under MIT, including
+rights in material from that baseline that remains in later versions. They
+apply to otherwise unlicensed additions and changes made available under
+this license. Merely changing a license notice or version number does not
+make previously MIT-licensed code exclusively subject to these restrictions.
+
+Third-party components and separately identified material retain their own
+licenses. Those licenses prevail for that material. Nothing here restricts
+rights that you hold independently under another applicable license or law.
+
+2. Noncommercial permission
+
+Subject to compliance with these terms, gekko grants you a worldwide,
+nonexclusive, royalty-free copyright license to obtain, inspect, reproduce,
+install, execute, and modify the Software solely for Noncommercial Purposes.
+You may distribute it only as permitted by section 4. No commercial permission
+is granted by this section.
+
+"Noncommercial Purposes" are activities that are not directed toward, intended
+to obtain, or reasonably expected to support commercial advantage, revenue,
+remuneration, or the operation of a business, whether directly or indirectly,
+for you or another person or entity. Purely personal hobby use, private study,
+and independent noncommercial research qualify when they satisfy this test.
+
+3. Commercial use requires a separate agreement
+
+Use outside Noncommercial Purposes requires a separate commercial license
+expressly granted by an authorized representative of gekko before that use.
+This includes, without limitation:
+
+  a. Use in or in support of a business, including internal business operations,
+     commercial research or development, business websites, and marketing.
+  b. Use in paid work, consulting, agency services, or client projects, including
+     work supplied without a separate charge for the Software itself.
+  c. Sale, rental, paid distribution, commercial sublicensing, or inclusion in
+     a commercial product, subscription, bundle, or service.
+  d. Commercial hosting, managed services, software as a service, or offering
+     the Software's functionality as part of a revenue-generating service.
+  e. Use supporting advertising, affiliate income, sponsorship in exchange for
+     exposure or benefits, paid access, or sales of goods or services.
+
+A charitable, educational, governmental, or nonprofit status does not by
+itself make an otherwise commercial activity noncommercial. Making access
+free, operating without profit, or charging for surrounding services instead
+of the Software does not exempt a use that otherwise meets the commercial
+criteria. If a use has both commercial and noncommercial purposes, commercial
+permission is required for that use.
+
+Commercial permission must be recorded in a written or express electronic
+agreement with gekko that identifies the rights granted. A download, public
+repository, donation, unanswered request, or payment without an applicable
+license agreement does not by itself grant commercial rights. An applicable
+separate agreement governs the rights it expressly grants.
+
+4. Copies, modifications, and redistribution
+
+For Noncommercial Purposes, you may share original or modified copies without
+charging a fee or receiving other compensation for them, provided that:
+
+  a. You include this license and preserve applicable copyright, attribution,
+     third-party, and legacy-license notices with each copy.
+  b. You identify your modifications and do not present a modified version as
+     an official gekko release or imply gekko's endorsement.
+  c. You grant recipients the same noncommercial permissions in your own
+     modifications, subject to the same limitations, and preserve the
+     conditions on gekko's material without granting rights you do not hold.
+  d. The distribution and its intended use satisfy sections 2 and 3.
+
+These conditions do not relicense independent programs or third-party
+components. Every recipient obtains any permission in gekko's material from
+gekko under this license, rather than through a right to sublicense granted
+to you. You retain rights in your own original contributions, subject to any
+agreement you separately make with gekko.
+
+Rights to view or fork a public repository that are independently granted
+under the applicable hosting platform's terms are unaffected. Such platform
+permissions do not themselves grant additional commercial-use rights under
+this license.
+
+5. Rights reserved to gekko
+
+gekko may use and commercialize material it owns or controls, offer paid
+licenses, subscriptions, hosting, support, or other services, and license
+that material to others on different terms. This license does not require
+gekko to provide future releases, updates, support, or commercial licenses.
+
+Future releases may be offered under different terms. Such a change does not
+retroactively change rights granted for a copy already licensed to you. The
+current grant continues for that copy while you comply with its conditions.
+
+6. Contributions and ownership
+
+This license does not transfer ownership of your contributions to gekko and
+does not, on its own, authorize gekko to commercially relicense those
+contributions. Inclusion of external contributions in the official project
+requires a separate rights agreement sufficient for the project's commercial
+licensing model. See CONTRIBUTING.md. Submission alone is not a substitute
+for that agreement.
+
+7. Other rights
+
+No trademark, trade-name, logo, endorsement, or patent license is granted by
+these terms. You may use names as reasonably necessary for truthful
+identification and attribution, subject to applicable law. All permissions
+not expressly granted or independently held are reserved.
+
+8. Breach and termination
+
+The permissions granted by this license terminate automatically if you
+materially breach its conditions or use the Software beyond their scope.
+You must then stop activities that depend on those permissions and cease
+distributing copies under them. Reinstatement requires gekko's express
+written permission. Obligations concerning notices, existing third-party
+rights, and liability survive termination to the extent applicable.
+
+Termination under these terms does not terminate independently held rights,
+including the MIT rights described in section 1. Nothing here excludes any
+notice, remedy, or cure period required by applicable law.
+
+9. Warranty and liability
+
+To the extent permitted by applicable law, the Software is provided "as is"
+and "as available", without promises or warranties concerning fitness for a
+particular purpose, merchantability, accuracy, availability, security, title,
+or noninfringement. Unless separately agreed, gekko undertakes no obligation
+to maintain the Software or any external archive or encyclopedia service.
+
+To the extent permitted by applicable law, gekko is not liable for losses
+or damages arising from the Software or this license. This limitation does
+not exclude or limit liability for intent, gross negligence, injury to life,
+body or health, fraudulent concealment, an expressly assumed guarantee,
+mandatory product liability, or any other liability that cannot lawfully be
+excluded or limited. Mandatory statutory rights remain unaffected.
+
+10. Mandatory law and interpretation
+
+These terms do not restrict statutory exceptions, mandatory software-user
+rights, or other rights that cannot lawfully be waived. If a provision is
+unenforceable, it applies only to the extent permitted by law; the remaining
+provisions continue to apply to the extent legally possible. No failure or
+delay to enforce a provision constitutes a general waiver or grants a new
+license. A change or exception for a particular licensee requires gekko's
+express written or electronic agreement.
+
+This is a source-available, noncommercial license. It is not an OSI-approved
+open-source license and does not grant unrestricted commercial use.

package/LICENSES/MIT-legacy.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Relink contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# Relink
+
+External link maintenance for EmDash. Relink inventories published links, checks them in the background, uses verified Wayback captures after repeated failures, and keeps a review history. Original content, drafts and revisions are never rewritten.
+
+**Compatibility:** EmDash 0.37.0, Astro 7.3.1, React 19 and Lingui 5. English and German interfaces; automatic or forced text direction. This is a native plugin, installed through your site's configuration; it is not a sandbox marketplace bundle.
+
+**Licensing:** [Relink Noncommercial License 1.0](LICENSE). Noncommercial use is free; commercial use of material governed by the new license requires a separate agreement with **gekko mbH** at [info2504@gekko.de](mailto:info2504@gekko.de). This is source-available software, not OSI-approved open source. **The previously released 0.1.0 code retains its MIT permissions, including commercial use.** The licensing transition started with version 0.2.0. See [licensing and commercial use](docs/licensing.md) for the exact scope and the rights needed for external contributions.
+
+## Install
+
+Install the released package in your EmDash site:
+
+```sh
+pnpm add emdash-plugin-relink@0.2.2
+```
+
+Keep EmDash and `@emdash-cms/admin` at 0.37.0, React on major version 19, and Lingui on major version 5. If your package manager does not install peer dependencies automatically, add the matching admin and Lingui packages explicitly.
+
+To build a distribution archive from source instead:
+
+```sh
+pnpm install --frozen-lockfile
+pnpm check
+pnpm pack --pack-destination work/artifacts
+```
+
+Install the resulting `emdash-plugin-relink-0.2.2.tgz` in the host site.
+
+```ts
+// astro.config.ts
+import { defineConfig } from "astro/config";
+import node from "@astrojs/node";
+import react from "@astrojs/react";
+import emdash from "emdash/astro";
+import { sqlite } from "emdash/db";
+import { relink } from "emdash-plugin-relink";
+import { relinkAstro } from "emdash-plugin-relink/astro";
+
+export default defineConfig({
+  output: "server",
+  adapter: node({ mode: "standalone" }),
+  integrations: [
+    react(),
+    emdash({
+      database: sqlite({ url: "file:./data.db" }),
+      plugins: [
+        relink({
+          siteUrl: "https://your-site.example",
+          sources: [
+            {
+              collection: "posts",
+              path: "/posts/{slug}",
+              portableTextFields: ["content"],
+              urlFields: ["website", "content[].url"],
+            },
+          ],
+        }),
+      ],
+    }),
+    relinkAstro(),
+  ],
+});
+```
+
+Open **Relink** in the EmDash navigation and choose **Scan published content**. This registers the recurring job if it does not already exist. Saving, publishing, unpublishing and deleting content also queue a scan of published entries. Node uses EmDash's scheduler. Cloudflare needs the supported Worker entry and a Cron Trigger; see [installation](docs/installation.md).
+
+## Behaviour
+
+| Situation                   | Default                                                     |
+| --------------------------- | ----------------------------------------------------------- |
+| New published target        | Check in a background batch                                 |
+| Reachable target            | Check again in seven days                                   |
+| Confirmed failure           | Retry after 24 hours and 72 hours from the first failure    |
+| Three confirmed failures    | Discover and verify an existing Wayback capture             |
+| Archive in use              | Review and recheck after seven days                         |
+| No suitable capture         | Retry discovery after 30 days                               |
+| Archive service unavailable | Retry discovery after one day                               |
+| Original recovers           | Restore after two successful checks at least 24 hours apart |
+| Undo automatic replacement  | Preserve an exception across scans and restarts             |
+
+Authentication, bot blocking, rate limiting and local outages are distinct from broken links. Grokipedia matching is optional and disabled by default. Matching slugs alone never permit a replacement; language, canonical identity, visible article evidence and section targets must match.
+
+The admin includes filters, CSV export, a history view, source excerpts and editor links, manual actions, a dashboard widget and a content-editor panel. It follows the active EmDash language without adding a language selector. RTL is a presentation option, not an Arabic or Hebrew translation.
+
+## Development and verification
+
+```sh
+pnpm check                    # strict types, lint, unit/integration tests, package build
+pnpm test:package             # install the tarball in an isolated EmDash site
+node scripts/seed-browser.mjs  # deterministic published-link index for browser tests
+pnpm test:browser             # browser regression suite for that installed package
+pnpm --filter relink-example-cloudflare build
+```
+
+[Architecture and API](docs/architecture.md) · [Configuration](docs/configuration.md) · [Recovery rules](docs/recovery.md) · [Translation and RTL](docs/translations.md) · [Testing and limitations](docs/testing.md) · [Release notes](CHANGELOG.md)

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,19 @@
+# Third-party and historical licensing
+
+The Relink Noncommercial License governs only material identified as subject to it and only rights controlled by gekko. It does not supersede licenses on dependencies or previously MIT-licensed Relink material.
+
+The original Relink 0.1.0 MIT notice is retained verbatim in [LICENSES/MIT-legacy.txt](LICENSES/MIT-legacy.txt). See [the licensing transition](docs/licensing.md#existing-mit-rights-remain).
+
+## Runtime dependencies and host integration
+
+| Component                      | License in the validated baseline | Where to find the notice                          |
+| ------------------------------ | --------------------------------- | ------------------------------------------------- |
+| parse5 8.0.1                   | MIT                               | Installed parse5 package                          |
+| Zod 4.5.4                      | MIT                               | Installed zod package                             |
+| EmDash and EmDash admin 0.37.0 | MIT                               | Installed emdash and @emdash-cms/admin packages   |
+| Astro 7.3.1                    | MIT                               | Installed astro package                           |
+| React 19                       | MIT                               | Installed react package                           |
+| Lingui 5                       | MIT                               | Installed @lingui/core and @lingui/react packages |
+| Kumo 2.6                       | MIT                               | Installed @cloudflare/kumo package                |
+
+Relink's package contains its own emitted modules and imports these dependencies or host-provided peers. It does not replace their license files. If you bundle or redistribute their code, include the applicable notices from the exact versions distributed. This table is a guide to the direct runtime and host components, not a substitute for reviewing all transitive or development dependencies in a redistributed installation.

package/dist/admin/app.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+import type { AdminClient } from "./client.js";
+export declare function RelinkApp({ client, compact, contentId, collection, }: {
+    client?: AdminClient;
+    compact?: boolean;
+    contentId?: string;
+    collection?: string;
+}): ReactNode;
+//# sourceMappingURL=app.d.ts.map

package/dist/admin/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/admin/app.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAavC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA0I/C,wBAAgB,SAAS,CAAC,EACxB,MAAoB,EACpB,OAAe,EACf,SAAc,EACd,UAAe,GAChB,EAAE;IACD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,SAAS,CAoqBZ"}