@kontrolia/shared 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KontrolIA Auth Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @kontrolia/shared
+
+Tipos y utilidades TypeScript compartidos por todos los paquetes y apps de [KontrolIA Auth](https://github.com/rauldolores/auth) (claims del JWT, tipos de usuario/organización, constantes). No suele instalarse directamente — llega como dependencia transitiva de `@kontrolia/auth`, `@kontrolia/react`, etc.
+
+## Instalación
+
+```bash
+npm install @kontrolia/shared
+```
+
+## Documentación
+
+Ver la [guía completa](https://github.com/rauldolores/auth) del monorepo.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./permission-key.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./permission-key.js";

package/dist/permission-key.d.ts

@@ -0,0 +1,13 @@
+import type { PermissionKey } from "./types.js";
+/**
+ * Permission keys are dot-separated hierarchies:
+ * "<application>.<resource>.<action>", e.g. "facturacion.facturas.crear".
+ */
+export interface ParsedPermissionKey {
+    application: string;
+    resource: string;
+    action: string;
+}
+export declare function parsePermissionKey(key: PermissionKey): ParsedPermissionKey;
+export declare function buildPermissionKey(parts: ParsedPermissionKey): PermissionKey;
+//# sourceMappingURL=permission-key.d.ts.map

package/dist/permission-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-key.d.ts","sourceRoot":"","sources":["../src/permission-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,mBAAmB,CAS1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa,CAE5E"}

package/dist/permission-key.js

@@ -0,0 +1,11 @@
+export function parsePermissionKey(key) {
+    const segments = key.split(".");
+    if (segments.length !== 3) {
+        throw new Error(`Invalid permission key "${key}": expected "<application>.<resource>.<action>"`);
+    }
+    const [application, resource, action] = segments;
+    return { application, resource, action };
+}
+export function buildPermissionKey(parts) {
+    return `${parts.application}.${parts.resource}.${parts.action}`;
+}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export interface KontroliaUser {
+    id: string;
+    email: string | null;
+    fullName: string | null;
+    avatarUrl: string | null;
+    locale: string | null;
+    timezone: string | null;
+    lastSeenAt: string | null;
+}
+export interface KontroliaOrganization {
+    id: string;
+    name: string;
+    slug: string;
+    settings: Record<string, unknown>;
+}
+export interface KontroliaMembership {
+    id: string;
+    organizationId: string;
+    status: "active" | "invited" | "suspended";
+    roles: string[];
+}
+/**
+ * Shape of the custom claims injected by kontrolia.custom_access_token_hook
+ * (see packages/db/migrations/0007_custom_access_token_hook.sql). Present
+ * under the top-level JWT claims, decoded by @kontrolia/auth.
+ */
+export interface KontroliaTokenClaims {
+    sub: string;
+    /** Correlates to auth.sessions.id — used to identify/revoke this specific device's session. */
+    session_id: string;
+    organization_id: string | null;
+    roles: string[];
+    permissions: string[];
+    exp: number;
+    [key: string]: unknown;
+}
+export interface KontroliaInvitation {
+    id: string;
+    organizationId: string;
+    email: string;
+    roleId: string | null;
+    expiresAt: string;
+}
+/** A single "resource.action" permission key, e.g. "facturacion.facturas.crear". */
+export type PermissionKey = string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,+FAA+F;IAC/F,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC"}

package/dist/types.js

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kontrolia/shared",
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "Shared TypeScript types and utilities used across every KontrolIA Auth package and app.",
+  "keywords": [
+    "kontrolia",
+    "auth",
+    "types"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rauldolores/auth.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/rauldolores/auth#readme",
+  "bugs": "https://github.com/rauldolores/auth/issues",
+  "author": "KontrolIA",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "eslint": "^9.17.0",
+    "typescript": "^5.7.2",
+    "@kontrolia/config": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rimraf dist"
+  }
+}