createAlfizClient: Initialize the Alfiz Client Instance

function createAlfizClient<Cat extends AnyCatalog>(
  options: Omit<AlfizClientOptions, "catalog"> & { catalog: Cat },
): AlfizClient<Cat["$key"], Cat["$pattern"], Cat["$scope"]>

import { type ClientOf } from "@alfiz/core";
// ClientOf<typeof catalog> ≡ AlfizClient<
//   KeyOf<typeof catalog>, PatternOf<typeof catalog>, ScopeOf<typeof catalog>
// >

import { type ClientOf } from "@alfiz/core";
import { catalog } from "./catalog.js";

// ✅ Clean annotation for context objects
type AppContext = {
  alfiz: ClientOf<typeof catalog>;
};

client.close(): void

import { defineCatalog, group, createAlfizClient } from "@alfiz/core";
import { createApplication } from "@alfiz/application";
import { prismaDriver } from "@alfiz/prisma";

// 1. Define the catalog (once, at the module level).
export const catalog = defineCatalog({
  namespaces: ["docs"],
  permissions: group("docs.files", { scopes: ["docs.folder", "docs.doc"] }, {
    "docs.files.read":        true,
    "docs.files.update_file": true,
    "docs.files.delete":      { destructive: true, scopes: ["docs.folder"] },
  }),
  scopeTypes: {
    "docs.folder": { parent: null },
    "docs.doc":    { parent: "docs.folder" },
  },
});

// 2. Construct the provider, wiring in storage and the ancestry resolver.
//    `ancestry` returns the chain nearest-first, EXCLUDING the scope itself.
const app = createApplication({
  catalog,
  storage: prismaDriver(prisma),
  ancestry: async (scope) => db.ancestorChainOf(scope),
});

// 3. Create the client and export it for use across the application.
export const alfiz = createAlfizClient({
  catalog,
  provider: app,
  subjectCacheTtlMs: 30_000,
  objectCacheTtlMs:  60_000,
});

// 4. On server shutdown, detach cleanly.
process.on("SIGTERM", () => {
  alfiz.close();
});

import { createApplication } from "@alfiz/application";
import { createAlfizClient, respCacheStore } from "@alfiz/core";
import { createClient } from "redis";

const app = createApplication({
  catalog,
  storage: prismaDriver(prisma),
  ancestry,
  events: { persist: true }, // durable invalidation log (the default with this driver)
});

const redis = createClient({ url: process.env.REDIS_URL });
await redis.connect();

export const alfiz = createAlfizClient({
  catalog,
  provider: app,
  revalidateAfterMs: 5_000,        // cross-process staleness bound
  cacheStore: respCacheStore(redis), // shared L2 for cold starts
});