namespace-guard 0.1.0

package/dist/adapters/knex.d.ts

@@ -0,0 +1,36 @@
+import { NamespaceAdapter } from '../index.js';
+
+type KnexQueryBuilder = {
+    select: (columns: string[]) => KnexQueryBuilder;
+    where: (column: string, value: unknown) => KnexQueryBuilder;
+    first: () => Promise<Record<string, unknown> | undefined>;
+};
+type KnexInstance = {
+    (tableName: string): KnexQueryBuilder;
+};
+/**
+ * Create a namespace adapter for Knex
+ *
+ * @example
+ * ```ts
+ * import Knex from "knex";
+ * import { createNamespaceGuard } from "namespace-guard";
+ * import { createKnexAdapter } from "namespace-guard/adapters/knex";
+ *
+ * const knex = Knex({ client: "pg", connection: process.env.DATABASE_URL });
+ *
+ * const guard = createNamespaceGuard(
+ *   {
+ *     reserved: ["admin", "api", "settings"],
+ *     sources: [
+ *       { name: "users", column: "handle", scopeKey: "id" },
+ *       { name: "organizations", column: "slug", scopeKey: "id" },
+ *     ],
+ *   },
+ *   createKnexAdapter(knex)
+ * );
+ * ```
+ */
+declare function createKnexAdapter(knex: KnexInstance): NamespaceAdapter;
+
+export { createKnexAdapter };

package/dist/adapters/knex.js

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/knex.ts
+var knex_exports = {};
+__export(knex_exports, {
+  createKnexAdapter: () => createKnexAdapter
+});
+module.exports = __toCommonJS(knex_exports);
+function createKnexAdapter(knex) {
+  return {
+    async findOne(source, value) {
+      const idColumn = source.idColumn ?? "id";
+      const columns = source.scopeKey && source.scopeKey !== idColumn ? [idColumn, source.scopeKey] : [idColumn];
+      const row = await knex(source.name).select(columns).where(source.column, value).first();
+      return row ?? null;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createKnexAdapter
+});

package/dist/adapters/knex.mjs

@@ -0,0 +1,14 @@
+// src/adapters/knex.ts
+function createKnexAdapter(knex) {
+  return {
+    async findOne(source, value) {
+      const idColumn = source.idColumn ?? "id";
+      const columns = source.scopeKey && source.scopeKey !== idColumn ? [idColumn, source.scopeKey] : [idColumn];
+      const row = await knex(source.name).select(columns).where(source.column, value).first();
+      return row ?? null;
+    }
+  };
+}
+export {
+  createKnexAdapter
+};

package/dist/adapters/kysely.d.mts

@@ -0,0 +1,37 @@
+import { NamespaceAdapter } from '../index.mjs';
+
+type KyselyQueryBuilder = {
+    select: (columns: string[]) => KyselyQueryBuilder;
+    where: (column: string, operator: string, value: unknown) => KyselyQueryBuilder;
+    limit: (limit: number) => KyselyQueryBuilder;
+    executeTakeFirst: () => Promise<Record<string, unknown> | undefined>;
+};
+type KyselyDb = {
+    selectFrom: (table: string) => KyselyQueryBuilder;
+};
+/**
+ * Create a namespace adapter for Kysely
+ *
+ * @example
+ * ```ts
+ * import { Kysely, PostgresDialect } from "kysely";
+ * import { createNamespaceGuard } from "namespace-guard";
+ * import { createKyselyAdapter } from "namespace-guard/adapters/kysely";
+ *
+ * const db = new Kysely<Database>({ dialect: new PostgresDialect({ pool }) });
+ *
+ * const guard = createNamespaceGuard(
+ *   {
+ *     reserved: ["admin", "api", "settings"],
+ *     sources: [
+ *       { name: "users", column: "handle", scopeKey: "id" },
+ *       { name: "organizations", column: "slug", scopeKey: "id" },
+ *     ],
+ *   },
+ *   createKyselyAdapter(db)
+ * );
+ * ```
+ */
+declare function createKyselyAdapter(db: KyselyDb): NamespaceAdapter;
+
+export { createKyselyAdapter };

package/dist/adapters/kysely.d.ts

@@ -0,0 +1,37 @@
+import { NamespaceAdapter } from '../index.js';
+
+type KyselyQueryBuilder = {
+    select: (columns: string[]) => KyselyQueryBuilder;
+    where: (column: string, operator: string, value: unknown) => KyselyQueryBuilder;
+    limit: (limit: number) => KyselyQueryBuilder;
+    executeTakeFirst: () => Promise<Record<string, unknown> | undefined>;
+};
+type KyselyDb = {
+    selectFrom: (table: string) => KyselyQueryBuilder;
+};
+/**
+ * Create a namespace adapter for Kysely
+ *
+ * @example
+ * ```ts
+ * import { Kysely, PostgresDialect } from "kysely";
+ * import { createNamespaceGuard } from "namespace-guard";
+ * import { createKyselyAdapter } from "namespace-guard/adapters/kysely";
+ *
+ * const db = new Kysely<Database>({ dialect: new PostgresDialect({ pool }) });
+ *
+ * const guard = createNamespaceGuard(
+ *   {
+ *     reserved: ["admin", "api", "settings"],
+ *     sources: [
+ *       { name: "users", column: "handle", scopeKey: "id" },
+ *       { name: "organizations", column: "slug", scopeKey: "id" },
+ *     ],
+ *   },
+ *   createKyselyAdapter(db)
+ * );
+ * ```
+ */
+declare function createKyselyAdapter(db: KyselyDb): NamespaceAdapter;
+
+export { createKyselyAdapter };

package/dist/adapters/kysely.js

@@ -0,0 +1,39 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/kysely.ts
+var kysely_exports = {};
+__export(kysely_exports, {
+  createKyselyAdapter: () => createKyselyAdapter
+});
+module.exports = __toCommonJS(kysely_exports);
+function createKyselyAdapter(db) {
+  return {
+    async findOne(source, value) {
+      const idColumn = source.idColumn ?? "id";
+      const columns = source.scopeKey && source.scopeKey !== idColumn ? [idColumn, source.scopeKey] : [idColumn];
+      const row = await db.selectFrom(source.name).select(columns).where(source.column, "=", value).limit(1).executeTakeFirst();
+      return row ?? null;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createKyselyAdapter
+});

package/dist/adapters/kysely.mjs

@@ -0,0 +1,14 @@
+// src/adapters/kysely.ts
+function createKyselyAdapter(db) {
+  return {
+    async findOne(source, value) {
+      const idColumn = source.idColumn ?? "id";
+      const columns = source.scopeKey && source.scopeKey !== idColumn ? [idColumn, source.scopeKey] : [idColumn];
+      const row = await db.selectFrom(source.name).select(columns).where(source.column, "=", value).limit(1).executeTakeFirst();
+      return row ?? null;
+    }
+  };
+}
+export {
+  createKyselyAdapter
+};

package/dist/adapters/prisma.d.mts

@@ -0,0 +1,36 @@
+import { NamespaceAdapter } from '../index.mjs';
+
+type PrismaClient = {
+    [key: string]: {
+        findFirst: (args: {
+            where: Record<string, unknown>;
+            select?: Record<string, boolean>;
+        }) => Promise<Record<string, unknown> | null>;
+    };
+};
+/**
+ * Create a namespace adapter for Prisma
+ *
+ * @example
+ * ```ts
+ * import { PrismaClient } from "@prisma/client";
+ * import { createNamespaceGuard } from "namespace-guard";
+ * import { createPrismaAdapter } from "namespace-guard/adapters/prisma";
+ *
+ * const prisma = new PrismaClient();
+ *
+ * const guard = createNamespaceGuard(
+ *   {
+ *     reserved: ["admin", "api", "settings"],
+ *     sources: [
+ *       { name: "user", column: "handle", scopeKey: "userId" },
+ *       { name: "organization", column: "slug", scopeKey: "orgId" },
+ *     ],
+ *   },
+ *   createPrismaAdapter(prisma)
+ * );
+ * ```
+ */
+declare function createPrismaAdapter(prisma: PrismaClient): NamespaceAdapter;
+
+export { createPrismaAdapter };

package/dist/adapters/prisma.d.ts

@@ -0,0 +1,36 @@
+import { NamespaceAdapter } from '../index.js';
+
+type PrismaClient = {
+    [key: string]: {
+        findFirst: (args: {
+            where: Record<string, unknown>;
+            select?: Record<string, boolean>;
+        }) => Promise<Record<string, unknown> | null>;
+    };
+};
+/**
+ * Create a namespace adapter for Prisma
+ *
+ * @example
+ * ```ts
+ * import { PrismaClient } from "@prisma/client";
+ * import { createNamespaceGuard } from "namespace-guard";
+ * import { createPrismaAdapter } from "namespace-guard/adapters/prisma";
+ *
+ * const prisma = new PrismaClient();
+ *
+ * const guard = createNamespaceGuard(
+ *   {
+ *     reserved: ["admin", "api", "settings"],
+ *     sources: [
+ *       { name: "user", column: "handle", scopeKey: "userId" },
+ *       { name: "organization", column: "slug", scopeKey: "orgId" },
+ *     ],
+ *   },
+ *   createPrismaAdapter(prisma)
+ * );
+ * ```
+ */
+declare function createPrismaAdapter(prisma: PrismaClient): NamespaceAdapter;
+
+export { createPrismaAdapter };

package/dist/adapters/prisma.js

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/prisma.ts
+var prisma_exports = {};
+__export(prisma_exports, {
+  createPrismaAdapter: () => createPrismaAdapter
+});
+module.exports = __toCommonJS(prisma_exports);
+function createPrismaAdapter(prisma) {
+  return {
+    async findOne(source, value) {
+      const model = prisma[source.name];
+      if (!model) {
+        throw new Error(`Prisma model "${source.name}" not found`);
+      }
+      const idColumn = source.idColumn ?? "id";
+      return model.findFirst({
+        where: { [source.column]: value },
+        select: {
+          [idColumn]: true,
+          ...source.scopeKey ? { [source.scopeKey]: true } : {}
+        }
+      });
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPrismaAdapter
+});

package/dist/adapters/prisma.mjs

@@ -0,0 +1,22 @@
+// src/adapters/prisma.ts
+function createPrismaAdapter(prisma) {
+  return {
+    async findOne(source, value) {
+      const model = prisma[source.name];
+      if (!model) {
+        throw new Error(`Prisma model "${source.name}" not found`);
+      }
+      const idColumn = source.idColumn ?? "id";
+      return model.findFirst({
+        where: { [source.column]: value },
+        select: {
+          [idColumn]: true,
+          ...source.scopeKey ? { [source.scopeKey]: true } : {}
+        }
+      });
+    }
+  };
+}
+export {
+  createPrismaAdapter
+};

package/dist/adapters/raw.d.mts

@@ -0,0 +1,34 @@
+import { NamespaceAdapter } from '../index.mjs';
+
+type QueryExecutor = (sql: string, params: unknown[]) => Promise<{
+    rows: Record<string, unknown>[];
+}>;
+/**
+ * Create a namespace adapter for raw SQL queries
+ *
+ * Works with any database client that can execute parameterized queries
+ * (pg, mysql2, better-sqlite3, etc.)
+ *
+ * @example
+ * ```ts
+ * import { Pool } from "pg";
+ * import { createNamespaceGuard } from "namespace-guard";
+ * import { createRawAdapter } from "namespace-guard/adapters/raw";
+ *
+ * const pool = new Pool();
+ *
+ * const guard = createNamespaceGuard(
+ *   {
+ *     reserved: ["admin", "api", "settings"],
+ *     sources: [
+ *       { name: "users", column: "handle", scopeKey: "id" },
+ *       { name: "organizations", column: "slug", scopeKey: "id" },
+ *     ],
+ *   },
+ *   createRawAdapter((sql, params) => pool.query(sql, params))
+ * );
+ * ```
+ */
+declare function createRawAdapter(execute: QueryExecutor): NamespaceAdapter;
+
+export { createRawAdapter };

package/dist/adapters/raw.d.ts

@@ -0,0 +1,34 @@
+import { NamespaceAdapter } from '../index.js';
+
+type QueryExecutor = (sql: string, params: unknown[]) => Promise<{
+    rows: Record<string, unknown>[];
+}>;
+/**
+ * Create a namespace adapter for raw SQL queries
+ *
+ * Works with any database client that can execute parameterized queries
+ * (pg, mysql2, better-sqlite3, etc.)
+ *
+ * @example
+ * ```ts
+ * import { Pool } from "pg";
+ * import { createNamespaceGuard } from "namespace-guard";
+ * import { createRawAdapter } from "namespace-guard/adapters/raw";
+ *
+ * const pool = new Pool();
+ *
+ * const guard = createNamespaceGuard(
+ *   {
+ *     reserved: ["admin", "api", "settings"],
+ *     sources: [
+ *       { name: "users", column: "handle", scopeKey: "id" },
+ *       { name: "organizations", column: "slug", scopeKey: "id" },
+ *     ],
+ *   },
+ *   createRawAdapter((sql, params) => pool.query(sql, params))
+ * );
+ * ```
+ */
+declare function createRawAdapter(execute: QueryExecutor): NamespaceAdapter;
+
+export { createRawAdapter };

package/dist/adapters/raw.js

@@ -0,0 +1,40 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/raw.ts
+var raw_exports = {};
+__export(raw_exports, {
+  createRawAdapter: () => createRawAdapter
+});
+module.exports = __toCommonJS(raw_exports);
+function createRawAdapter(execute) {
+  return {
+    async findOne(source, value) {
+      const idColumn = source.idColumn ?? "id";
+      const columns = source.scopeKey && source.scopeKey !== idColumn ? `"${idColumn}", "${source.scopeKey}"` : `"${idColumn}"`;
+      const sql = `SELECT ${columns} FROM "${source.name}" WHERE "${source.column}" = $1 LIMIT 1`;
+      const result = await execute(sql, [value]);
+      return result.rows[0] ?? null;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRawAdapter
+});

package/dist/adapters/raw.mjs

@@ -0,0 +1,15 @@
+// src/adapters/raw.ts
+function createRawAdapter(execute) {
+  return {
+    async findOne(source, value) {
+      const idColumn = source.idColumn ?? "id";
+      const columns = source.scopeKey && source.scopeKey !== idColumn ? `"${idColumn}", "${source.scopeKey}"` : `"${idColumn}"`;
+      const sql = `SELECT ${columns} FROM "${source.name}" WHERE "${source.column}" = $1 LIMIT 1`;
+      const result = await execute(sql, [value]);
+      return result.rows[0] ?? null;
+    }
+  };
+}
+export {
+  createRawAdapter
+};

package/dist/cli.d.mts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function run(argv?: string[]): Promise<number>;
+
+export { run };

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function run(argv?: string[]): Promise<number>;
+
+export { run };