@hasna/shortlinks 0.1.0

package/LICENSE

@@ -0,0 +1,152 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on or derived from the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner. For the purposes of this definition,
+"submitted" means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems, and
+issue tracking systems that are managed by, or on behalf of, the Licensor for
+the purpose of discussing and improving the Work, but excluding communication
+that is conspicuously marked or otherwise designated in writing by the copyright
+owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License,
+each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable patent license to make, have made, use,
+offer to sell, sell, import, and otherwise transfer the Work, where such license
+applies only to those patent claims licensable by such Contributor that are
+necessarily infringed by their Contribution alone or by combination of their
+Contribution with the Work to which such Contribution was submitted. If You
+institute patent litigation against any entity alleging that the Work or a
+Contribution incorporated within the Work constitutes direct or contributory
+patent infringement, then any patent licenses granted to You under this License
+for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any part
+of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the Derivative
+Works; within the Source form or documentation, if provided along with the
+Derivative Works; or within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents of the NOTICE
+file are for informational purposes only and do not modify the License. You may
+add Your own attribution notices within Derivative Works that You distribute,
+alongside or as an addendum to the NOTICE text from the Work, provided that such
+additional attribution notices cannot be construed as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction, or
+distribution of Your modifications, or for any such Derivative Works as a whole,
+provided Your use, reproduction, and distribution of the Work otherwise complies
+with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions. Notwithstanding the above, nothing herein shall
+supersede or modify the terms of any separate license agreement you may have
+executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied, including, without limitation,
+any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or
+FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any risks
+associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless required by
+applicable law or agreed to in writing, shall any Contributor be liable to You
+for damages, including any direct, indirect, special, incidental, or
+consequential damages arising as a result of this License or out of the use or
+inability to use the Work, even if such Contributor has been advised of the
+possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations
+and/or rights consistent with this License. However, in accepting such
+obligations, You may act only on Your own behalf and on Your sole
+responsibility, not on behalf of any other Contributor, and only if You agree to
+indemnify, defend, and hold each Contributor harmless for any liability incurred
+by, or claims asserted against, such Contributor by reason of your accepting any
+such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,151 @@
+# @hasna/shortlinks
+
+CLI-only shortlink management for custom domains.
+
+`shortlinks` creates Bitly-style short URLs, supports multiple domains, records click analytics, can run a tiny redirect server, and includes helper commands for Cloudflare DNS/Workers, `@hasna/domains`, and `@hasna/cloud` sync.
+
+[![npm](https://img.shields.io/npm/v/@hasna/shortlinks)](https://www.npmjs.com/package/@hasna/shortlinks)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+
+## Install
+
+```bash
+bun install -g @hasna/shortlinks
+```
+
+The local database lives at:
+
+```bash
+~/.hasna/shortlinks/shortlinks.db
+```
+
+## Quick Start
+
+```bash
+shortlinks init --domain has.na
+shortlinks create https://example.com --slug docs
+shortlinks serve --host 127.0.0.1 --port 8787
+```
+
+Then a request for `https://has.na/docs` redirects to `https://example.com` and records a click.
+
+## Agent-Friendly JSON
+
+Every operational command supports `--json`:
+
+```bash
+shortlinks --json create https://example.com --domain has.na
+shortlinks --json link list
+shortlinks --json stats docs --domain has.na
+shortlinks --json doctor
+```
+
+Errors are emitted as:
+
+```json
+{ "error": "message" }
+```
+
+## CLI
+
+```bash
+shortlinks init --domain has.na
+shortlinks domain add has.na --default
+shortlinks domain setup go.example.com --cloudflare --target shortlinks.example.com --dry-run
+shortlinks domain check example.ai
+shortlinks domain buy example.ai --dry-run
+
+shortlinks create https://example.com --slug home
+shortlinks link create https://example.com/docs --domain has.na --title Docs
+shortlinks link list
+shortlinks link get home --domain has.na
+shortlinks link disable home --domain has.na
+shortlinks link enable home --domain has.na
+shortlinks stats home --domain has.na
+
+shortlinks serve --port 8787
+shortlinks doctor
+```
+
+## Custom Domains
+
+Add as many domains as you need:
+
+```bash
+shortlinks domain add has.na --default
+shortlinks domain add go.example.com --provider cloudflare
+```
+
+Generated links use the default domain unless `--domain` is passed.
+
+## Cloudflare
+
+Create a dry-run plan:
+
+```bash
+shortlinks cloudflare plan has.na \
+  --target shortlinks.hasna.xyz \
+  --origin https://shortlinks.hasna.xyz
+```
+
+Write a Cloudflare Worker that forwards requests to the redirect server while preserving the original host:
+
+```bash
+shortlinks cloudflare worker \
+  --worker shortlinks \
+  --origin https://shortlinks.hasna.xyz
+```
+
+Upsert DNS when `CLOUDFLARE_API_TOKEN` is available:
+
+```bash
+shortlinks cloudflare dns has.na --target shortlinks.hasna.xyz
+```
+
+## Buying Domains
+
+Domain purchasing goes through the `domains` CLI from `@hasna/domains`:
+
+```bash
+shortlinks domain check new-short-domain.ai
+shortlinks domain buy new-short-domain.ai --dry-run
+```
+
+This package does not install or call any removed `connect-*` packages.
+
+## Cloud Sync
+
+`shortlinks` is compatible with `@hasna/cloud` conventions:
+
+```bash
+cloud setup
+shortlinks cloud migrate
+shortlinks cloud push
+shortlinks cloud pull
+shortlinks cloud sync
+```
+
+The cloud database service name is `shortlinks`.
+
+## Development
+
+```bash
+bun install
+bun test
+bun run typecheck
+bun run build
+```
+
+## Repository
+
+The OSS repository is expected to be:
+
+```text
+hasna/shortlinks
+```
+
+The local workspace folder may still be named `open-shortlinks`; the published package and GitHub repo do not use the `open-` prefix.
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).

package/SECURITY.md

@@ -0,0 +1,19 @@
+# Security
+
+Do not report security issues in public GitHub issues.
+
+Email security concerns to:
+
+```text
+andrei@hasna.com
+```
+
+## Secrets
+
+Never commit API tokens, Cloudflare credentials, AWS credentials, database passwords, `.env` files, or local SQLite databases.
+
+Use environment variables, the `secrets` CLI, or AWS Secrets Manager for deployment credentials.
+
+## Click Tracking
+
+The redirect server hashes IP addresses before storing them. Set `SHORTLINKS_CLICK_SALT` in production so hashes cannot be correlated with local development data.

package/cloudflare/shortlinks.js

@@ -0,0 +1,21 @@
+export default {
+  async fetch(request, env) {
+    const origin = env.SHORTLINKS_ORIGIN;
+    if (!origin) {
+      return new Response("SHORTLINKS_ORIGIN is not configured", { status: 500 });
+    }
+
+    const incoming = new URL(request.url);
+    const upstream = new URL(incoming.pathname + incoming.search, origin);
+    const headers = new Headers(request.headers);
+    headers.set("x-forwarded-host", incoming.host);
+    headers.set("x-shortlinks-worker", "cloudflare");
+
+    return fetch(upstream.toString(), {
+      method: request.method,
+      headers,
+      body: request.method === "GET" || request.method === "HEAD" ? undefined : request.body,
+      redirect: "manual"
+    });
+  }
+};

package/cloudflare/wrangler.example.toml

@@ -0,0 +1,6 @@
+name = "shortlinks"
+main = "shortlinks.js"
+compatibility_date = "2026-05-01"
+
+[vars]
+SHORTLINKS_ORIGIN = "https://shortlinks.hasna.xyz"

package/dist/cli/cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};