@hasna/shortlinks 0.1.24 → 0.2.1

package/dist/client-store.d.ts

@@ -0,0 +1,48 @@
+import { CloudShortlinksStore } from "./cloud-store.js";
+import type { Env } from "@hasna/contracts/mode";
+import type { ListLinksOptions, Store, TotalStats } from "./store-interface.js";
+import type { AddDomainInput, Click, ClickInput, CreateLinkInput, Domain, Link, LinkStats } from "./types.js";
+/** The self_hosted/cloud HTTP transport. Same client code for both tiers. */
+export { CloudShortlinksStore as ApiStore } from "./cloud-store.js";
+export type { Store } from "./store-interface.js";
+/**
+ * On-box SQLite store. An async adapter over the synchronous sqlite engine
+ * (`ShortlinksStore`) so it satisfies the shared async {@link Store} interface.
+ */
+export declare class LocalStore implements Store {
+    readonly kind: "local";
+    private readonly inner;
+    constructor(dbPath?: string);
+    addDomain(input: AddDomainInput): Promise<Domain>;
+    listDomains(): Promise<Domain[]>;
+    getDomain(hostnameOrId: string): Promise<Domain | null>;
+    getDefaultDomain(): Promise<Domain | null>;
+    deleteDomain(hostnameOrId: string): Promise<Domain>;
+    createLink(input: CreateLinkInput): Promise<Link>;
+    listLinks(options?: ListLinksOptions): Promise<Link[]>;
+    getLink(domainOrSlug: string, maybeSlug?: string): Promise<Link | null>;
+    resolve(hostname: string, slug: string): Promise<Link | null>;
+    setLinkActive(domainOrSlug: string, slugOrActive: string | boolean, active?: boolean): Promise<Link>;
+    deleteLink(domainOrSlug: string, maybeSlug?: string): Promise<Link>;
+    recordClick(link: Link, input?: ClickInput): Promise<Click>;
+    getStats(domainOrSlug: string, maybeSlug?: string): Promise<LinkStats>;
+    totalStats(): Promise<TotalStats>;
+    close(): Promise<void>;
+}
+export interface ResolveStoreOptions {
+    /** Explicit local SQLite path (CLI `--db`); ignored in cloud mode. */
+    dbPath?: string;
+    /** Transport overrides for the cloud client (test injection: fetchImpl, ...). */
+    cloudOverrides?: Parameters<typeof CloudShortlinksStore.fromEnv>[1];
+}
+/**
+ * Resolve the active {@link Store} for the current environment. Returns the
+ * cloud {@link ApiStore} when the client flip is on, otherwise a
+ * {@link LocalStore}. Throws when cloud was requested but is misconfigured.
+ */
+export declare function resolveStore(env?: Env, options?: ResolveStoreOptions): Store;
+/**
+ * Run `fn` with a resolved {@link Store}, always closing it afterward. The
+ * canonical helper for one-shot CLI/MCP operations.
+ */
+export declare function withStore<T>(fn: (store: Store) => T | Promise<T>, env?: Env, options?: ResolveStoreOptions): Promise<T>;

package/dist/cloud-store.d.ts

@@ -0,0 +1,47 @@
+import { resolveStorageClient, type HasnaStorageClient } from "@hasna/contracts/client/storage";
+import type { Env } from "@hasna/contracts/mode";
+import type { Store } from "./store-interface.js";
+import type { AddDomainInput, Click, ClickInput, CreateLinkInput, Domain, Link, LinkStats } from "./types.js";
+/**
+ * Cloud-backed shortlinks store. All methods hit `/v1` over HTTPS with the
+ * bearer key. Mirrors the async `PgShortlinksStore` method signatures so it is a
+ * drop-in `RuntimeStore` for the CLI.
+ */
+export declare class CloudShortlinksStore implements Store {
+    private readonly client;
+    readonly kind: "cloud-http";
+    readonly transport: HasnaStorageClient["transport"];
+    private constructor();
+    /** Base `<origin>/v1` URL this store targets (for status/diagnostics). */
+    get baseUrl(): string;
+    /**
+     * Resolve a cloud store from the environment. Returns the store when the
+     * client-flip resolves to `cloud-http` (self_hosted + API_URL + API_KEY), else
+     * null so the caller falls back to the local store. Throws only when cloud was
+     * explicitly requested but is misconfigured (never silent local drift).
+     */
+    static fromEnv(env?: Env, overrides?: Parameters<typeof resolveStorageClient>[2]): CloudShortlinksStore | null;
+    close(): Promise<void>;
+    addDomain(input: AddDomainInput): Promise<Domain>;
+    listDomains(): Promise<Domain[]>;
+    getDomain(hostnameOrId: string): Promise<Domain | null>;
+    getDefaultDomain(): Promise<Domain | null>;
+    deleteDomain(hostnameOrId: string): Promise<Domain>;
+    createLink(input: CreateLinkInput): Promise<Link>;
+    listLinks(options?: {
+        domain?: string;
+        activeOnly?: boolean;
+        limit?: number;
+    }): Promise<Link[]>;
+    getLink(domainOrSlug: string, maybeSlug?: string): Promise<Link | null>;
+    resolve(hostname: string, slug: string): Promise<Link | null>;
+    setLinkActive(domainOrSlug: string, maybeSlugOrActive: string | boolean, maybeActive?: boolean): Promise<Link>;
+    deleteLink(domainOrSlug: string, maybeSlug?: string): Promise<Link>;
+    recordClick(_link: Link, _input?: ClickInput): Promise<Click>;
+    getStats(domainOrSlug: string, maybeSlug?: string): Promise<LinkStats>;
+    totalStats(): Promise<{
+        domains: number;
+        links: number;
+        clicks: number;
+    }>;
+}

package/dist/db/migrations.d.ts

@@ -5,8 +5,8 @@
  * vendored storage kit's MigrationLedger. The service reads and writes the same
  * cloud database — there is no local mirror, cache, or sync engine here.
  *
- * The domains/links/clicks schema mirrors src/pg-migrations.ts (SQLite-parity
- * TEXT/INTEGER shapes) so the existing SaaS-remnant tables are matched exactly
+ * The domains/links/clicks schema uses SQLite-parity TEXT/INTEGER shapes so the
+ * existing SaaS-remnant tables are matched exactly
  * (every statement is `IF NOT EXISTS` — applying the ledger never clobbers data).
  * The api_keys table migrations come from @hasna/contracts/auth so the API-key
  * middleware and the `contracts issue-key` issuer share one schema.

package/dist/generated/storage-kit/index.d.ts

@@ -1,4 +1,4 @@
-export declare const KIT_VERSION = "0.4.1";
+export declare const KIT_VERSION = "0.4.2";
 export * from "./mode.js";
 export * from "./tls.js";
 export * from "./query.js";

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 export { ShortlinksDatabase, SQLITE_MIGRATIONS, makeId, now } from "./database.js";
 export { ShortlinksStore } from "./store.js";
-export { PgShortlinksStore, applyPostgresMigrations, createKitPgAdapter } from "./pg-store.js";
+export { LocalStore, ApiStore, resolveStore, withStore } from "./client-store.js";
+export { CloudShortlinksStore } from "./cloud-store.js";
+export type { Store, ListLinksOptions, TotalStats } from "./store-interface.js";
+export { PgShortlinksStore, createKitPgAdapter } from "./pg-store.js";
 export { SHORTLINKS_MIGRATIONS } from "./db/migrations.js";
 export { createServeApp } from "./serve/app.js";
 export { buildOpenApiDocument } from "./serve/openapi.js";
 export { createShortlinksHandler, serveShortlinks } from "./server.js";
 export { createCloudflarePlan, generateWorkerScript, writeWorkerFiles, upsertCloudflareDnsRecord } from "./cloudflare.js";
 export { createLocalSetupPlan, registerMachinesDns } from "./local.js";
-export { PG_MIGRATIONS } from "./pg-migrations.js";
-export { CANONICAL_SHORTLINKS_POSTGRES_CLUSTER, CANONICAL_SHORTLINKS_POSTGRES_DATABASE, CANONICAL_SHORTLINKS_RUNTIME_SECRET_PATH, SHORTLINKS_RUNTIME_ENV, SHORTLINKS_RUNTIME_FALLBACK_ENV, assertShortlinksPostgresConfig, getCanonicalShortlinksPostgresConfig, getShortlinksDatabaseSsl, getShortlinksDatabaseUrl, getShortlinksRuntimeEnvName, getShortlinksRuntimeStatus, getShortlinksStoreMode, loadShortlinksRuntimeConfig, parseShortlinksStoreMode, redactDatabaseUrl, } from "./runtime.js";
 export { formatShortUrl, getConfigPath, getDataDir, getDatabasePath, loadConfig, normalizeHostname, saveConfig } from "./config.js";
 export { normalizeSlug, randomToken } from "./slug.js";
 export type { AddDomainInput, Click, ClickInput, CreateLinkInput, Domain, Link, LinkStats } from "./types.js";
-export type { CanonicalShortlinksPostgresConfig, RuntimeEnvStatus, ShortlinksPostgresConfig, ShortlinksRuntimeConfig, ShortlinksRuntimeEnv, ShortlinksRuntimeStatus, ShortlinksStoreMode, } from "./runtime.js";