@hasna/hooks 0.5.0 → 0.6.0

package/dist/cf/provision.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cloudflare resource provisioning for the hooks registry (`hooks cf deploy`).
+ *
+ * Provisions D1 database + R2 bucket through the Cloudflare API. Worker upload
+ * requires wrangler (workerd target); this module prints the exact wrangler
+ * commands instead of shipping a token-bearing upload path.
+ */
+export interface ProvisionOptions {
+    token: string;
+    accountId: string;
+    databaseName: string;
+    bucketName: string;
+    dryRun: boolean;
+    fetchFn?: typeof fetch;
+}
+export interface ProvisionResult {
+    d1DatabaseId: string | null;
+    d1Created: boolean;
+    d1Exists: boolean;
+    r2BucketExists: boolean;
+    r2Created: boolean;
+    commands: string[];
+}
+export declare function provisionCloudflareResources(options: ProvisionOptions): Promise<ProvisionResult>;

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Runtime configuration for @hasna/hooks.
+ *
+ * Presence of an API URL selects the remote registry; absence means the local
+ * store is authoritative. There is deliberately no mode concept.
+ */
+export declare function getHooksDataDir(): string;
+export declare function getCustomHooksDir(): string;
+export declare function getLockPath(): string;
+export declare function getConfigPath(): string;
+export interface HooksConfig {
+    api_url?: string;
+    api_key_ref?: string;
+}
+export declare function readConfig(): HooksConfig;
+export declare function writeConfig(config: HooksConfig): string;
+export declare function resolveApiUrl(): string | undefined;
+export declare function resolveApiKey(flagKey?: string): string | undefined;

package/dist/db/legacy-import.d.ts

@@ -8,4 +8,4 @@
  * Tracks completion via a `_meta` table row keyed "legacy_import_done".
  */
 import type { Database } from "bun:sqlite";
-export declare function runLegacyImport(db: Database): void;
+export declare function runLegacyImport(db: Database, homeDir?: string): void;

package/dist/db/migrations/004_hooks_table.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration 004 — hooks tracking table.
+ * Records installed/pinned hooks with their trusted script hashes
+ * (mirrors the codewith trusted_hash model).
+ */
+import type { Database } from "bun:sqlite";
+export declare const CREATE_HOOKS_TABLE = "\n  CREATE TABLE IF NOT EXISTS hooks (\n    id               TEXT PRIMARY KEY,\n    name             TEXT NOT NULL,\n    version          TEXT NOT NULL,\n    sha256           TEXT NOT NULL,\n    source_type      TEXT NOT NULL,\n    source_ref       TEXT,\n    installed_at     TEXT NOT NULL,\n    enabled          INTEGER NOT NULL DEFAULT 1,\n    last_verified_at TEXT\n  )\n";
+export declare const CREATE_HOOKS_INDEXES: string[];
+export declare function up(db: Database): void;

package/dist/db/pg-migrations.d.ts

@@ -1,5 +1,5 @@
 /**
- * PostgreSQL migrations for open-hooks remote storage and sync.
+ * PostgreSQL migrations for the open-hooks PostgreSQL storage backend and sync.
  *
  * Equivalent to the SQLite schema in schema.ts, migrations/, and index.ts,
  * translated for PostgreSQL.

package/dist/db/storage-sync.d.ts

@@ -2,7 +2,15 @@ import { PgAdapterAsync } from "./remote-storage.js";
 export declare const STORAGE_TABLES: readonly ["hook_events", "schema_migrations", "_meta", "feedback"];
 export declare const HOOKS_STORAGE_TABLES: readonly ["hook_events", "schema_migrations", "_meta", "feedback"];
 type StorageTable = (typeof STORAGE_TABLES)[number];
-export type StorageMode = "local" | "hybrid" | "remote";
+/**
+ * The storage backend is a two-value data-backend switch, NOT a deployment mode.
+ *
+ * `local | hybrid | remote` (and the wider fleet's `self_hosted | cloud`) described *where*
+ * something ran, which is not a property of the data layer. They are retired: local collapses
+ * to `sqlite`, and every server-backed placement collapses to `postgresql`.
+ */
+export declare const STORAGE_BACKENDS: readonly ["sqlite", "postgresql"];
+export type StorageBackend = (typeof STORAGE_BACKENDS)[number];
 export interface StorageEnv {
     name: string;
 }
@@ -19,13 +27,19 @@ export interface SyncMeta {
 }
 export declare const HOOKS_STORAGE_ENV = "HASNA_HOOKS_DATABASE_URL";
 export declare const HOOKS_STORAGE_FALLBACK_ENV = "HOOKS_DATABASE_URL";
-export declare const HOOKS_STORAGE_MODE_ENV = "HASNA_HOOKS_STORAGE_MODE";
-export declare const HOOKS_STORAGE_MODE_FALLBACK_ENV = "HOOKS_STORAGE_MODE";
+export declare const HOOKS_STORAGE_BACKEND_ENV = "HASNA_HOOKS_STORAGE_BACKEND";
+export declare const HOOKS_STORAGE_BACKEND_FALLBACK_ENV = "HOOKS_STORAGE_BACKEND";
 export declare const STORAGE_DATABASE_ENV: readonly ["HASNA_HOOKS_DATABASE_URL", "HOOKS_DATABASE_URL"];
-export declare const STORAGE_MODE_ENV: readonly ["HASNA_HOOKS_STORAGE_MODE", "HOOKS_STORAGE_MODE"];
+export declare const STORAGE_BACKEND_ENV: readonly ["HASNA_HOOKS_STORAGE_BACKEND", "HOOKS_STORAGE_BACKEND"];
+/**
+ * Deployment-mode env vars that no longer exist. Reading one is an error rather than a no-op:
+ * an operator who set `HASNA_HOOKS_STORAGE_MODE=hybrid` believed they had configured something,
+ * and silently ignoring it is how a config change appears to work and does not.
+ */
+export declare const RETIRED_STORAGE_MODE_ENV: readonly ["HASNA_HOOKS_STORAGE_MODE", "HOOKS_STORAGE_MODE"];
 export interface StorageStatus {
     configured: boolean;
-    mode: StorageMode;
+    backend: StorageBackend;
     env: typeof STORAGE_DATABASE_ENV;
     activeEnv: string | null;
     service: "hooks";
@@ -35,7 +49,13 @@ export interface StorageStatus {
 export declare function getStorageDatabaseEnvName(): (typeof STORAGE_DATABASE_ENV)[number] | null;
 export declare function getStorageDatabaseEnv(): StorageEnv | null;
 export declare function getStorageDatabaseUrl(): string | null;
-export declare function getStorageMode(): StorageMode;
+/**
+ * Which data backend hooks storage talks to. Explicit configuration wins; otherwise the
+ * presence of a database URL is the answer, exactly as before.
+ *
+ * Throws — never silently falls back — on an unknown value or a retired deployment-mode name.
+ */
+export declare function getStorageBackend(): StorageBackend;
 export declare function getStoragePg(): Promise<PgAdapterAsync>;
 export declare function runStorageMigrations(remote: PgAdapterAsync): Promise<void>;
 export declare function storagePush(options?: {

package/dist/index.d.ts

@@ -68,5 +68,21 @@ export interface RunHookResult {
  */
 export declare function runHook(name: string, input: HookInput, options?: RunHookOptions): Promise<RunHookResult>;
 export { createProfile, getProfile, listProfiles, updateProfile, deleteProfile, touchProfile, getProfilesDir, exportProfiles, importProfiles, type AgentProfile, type CreateProfileInput, } from "./lib/profiles.js";
-export { HOOKS_STORAGE_ENV, HOOKS_STORAGE_FALLBACK_ENV, HOOKS_STORAGE_MODE_ENV, HOOKS_STORAGE_MODE_FALLBACK_ENV, HOOKS_STORAGE_TABLES, STORAGE_DATABASE_ENV, STORAGE_MODE_ENV, STORAGE_TABLES, getStorageDatabaseEnv, getStorageDatabaseEnvName, getStorageDatabaseUrl, getStorageMode, getStoragePg, getStorageStatus, getSyncMetaAll, parseStorageTables, resolveTables, runStorageMigrations, storagePull, storagePush, storageSync, } from "./storage.js";
-export type { StorageEnv, StorageMode, StorageStatus, SyncMeta, SyncResult } from "./storage.js";
+export { HOOKS_STORAGE_ENV, HOOKS_STORAGE_FALLBACK_ENV, HOOKS_STORAGE_BACKEND_ENV, HOOKS_STORAGE_BACKEND_FALLBACK_ENV, HOOKS_STORAGE_TABLES, RETIRED_STORAGE_MODE_ENV, STORAGE_BACKENDS, STORAGE_BACKEND_ENV, STORAGE_DATABASE_ENV, STORAGE_TABLES, getStorageBackend, getStorageDatabaseEnv, getStorageDatabaseEnvName, getStorageDatabaseUrl, getStoragePg, getStorageStatus, getSyncMetaAll, parseStorageTables, resolveTables, runStorageMigrations, storagePull, storagePush, storageSync, } from "./storage.js";
+export type { StorageBackend, StorageEnv, StorageStatus, SyncMeta, SyncResult } from "./storage.js";
+export { getHooksDataDir, getCustomHooksDir, getLockPath, getConfigPath, readConfig, writeConfig, resolveApiUrl, resolveApiKey, } from "./config.js";
+export type { HooksConfig } from "./config.js";
+export { getHookRecord, listHookRecords, upsertHookRecord, removeHookRecord, readLock, writeLock, setPinnedHook, getPinnedHook, removePinnedHook, verifyScriptHash, checkScriptHash, retrustHook, sha256Of, sha256File, } from "./lib/store.js";
+export type { HookRecord, LockEntry, LockFile, TrustCheck } from "./lib/store.js";
+export { parseManifest, readCustomManifest, listCustomHooks, writeCustomHook, resolveScript, } from "./lib/manifest.js";
+export type { HookManifest, ParsedManifest } from "./lib/manifest.js";
+export { resolveHook, resolveHookDir, resolveHookMeta, resolveScriptPath, } from "./lib/resolve.js";
+export type { ResolvedHook, HookSource } from "./lib/resolve.js";
+export { installCustomSource, isCustomSource, } from "./lib/custom-install.js";
+export type { CustomInstallResult, CustomSourceKind } from "./lib/custom-install.js";
+export { planSync, syncHooks, } from "./lib/sync.js";
+export type { SyncDiff, SyncPlan, ArtifactResponse } from "./lib/sync.js";
+export { handleServeRequest, startServeServer, DEFAULT_SERVE_PORT, } from "./serve.js";
+export type { CatalogEntry, ArtifactPayload } from "./serve.js";
+export { provisionCloudflareResources, } from "./cf/provision.js";
+export type { ProvisionOptions, ProvisionResult } from "./cf/provision.js";