@meago/core 0.2.0

package/dist/index.js

@@ -0,0 +1,328 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  API_ACTIONS: () => API_ACTIONS,
+  API_CONTROLLERS: () => API_CONTROLLERS,
+  API_VERSION: () => API_VERSION,
+  AuthMode: () => AuthMode,
+  CoreError: () => CoreError,
+  CoreErrorCode: () => CoreErrorCode,
+  ESortDir: () => ESortDir,
+  EUserStatus: () => EUserStatus,
+  MeagoApi: () => api_exports,
+  MeagoAuth: () => auth_exports2,
+  MeagoConstants: () => constants_exports,
+  MeagoDto: () => auth_exports,
+  MeagoEnums: () => enums_exports,
+  MeagoErrors: () => errors_exports,
+  MeagoInterfacesCommon: () => common_exports,
+  MeagoInterfacesModels: () => models_exports,
+  MeagoPagination: () => pagination_exports,
+  MeagoPermissions: () => permissions_exports,
+  MeagoPorts: () => ports_exports,
+  MeagoResult: () => result_exports,
+  PERMISSIONS: () => PERMISSIONS,
+  createErrorResponse: () => createErrorResponse,
+  createPaginatedResult: () => createPaginatedResult,
+  createSuccessResponse: () => createSuccessResponse,
+  err: () => err,
+  getPaginationOffset: () => getPaginationOffset,
+  hasAllPermissions: () => hasAllPermissions,
+  hasAnyPermission: () => hasAnyPermission,
+  isCoreError: () => isCoreError,
+  isErr: () => isErr,
+  isOk: () => isOk,
+  joinApiPath: () => joinApiPath,
+  mapResult: () => mapResult,
+  normalizePagination: () => normalizePagination,
+  ok: () => ok,
+  systemClock: () => systemClock,
+  unwrapResult: () => unwrapResult
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/constants/index.ts
+var constants_exports = {};
+__export(constants_exports, {
+  API_ACTIONS: () => API_ACTIONS,
+  API_CONTROLLERS: () => API_CONTROLLERS,
+  API_VERSION: () => API_VERSION,
+  PERMISSIONS: () => PERMISSIONS
+});
+var API_VERSION = "/api/v1";
+var API_CONTROLLERS = {
+  AUTH: "auth",
+  USERS: "users",
+  ROLES: "roles",
+  STORIES: "stories"
+};
+var API_ACTIONS = {
+  LOGIN: "login",
+  REGISTER: "register",
+  REFRESH: "refresh",
+  LOGOUT: "logout",
+  LOGOUT_ALL: "logout-all",
+  ME: "me"
+};
+var PERMISSIONS = {
+  USER: {
+    READ: "user:read",
+    MANAGE: "user:manage"
+  },
+  ROLE: {
+    READ: "role:read",
+    MANAGE: "role:manage"
+  },
+  STORY: {
+    CREATE: "story:create",
+    READ: "story:read",
+    MANAGE: "story:manage"
+  }
+};
+
+// src/enums/index.ts
+var enums_exports = {};
+__export(enums_exports, {
+  ESortDir: () => ESortDir,
+  EUserStatus: () => EUserStatus
+});
+var EUserStatus = /* @__PURE__ */ ((EUserStatus2) => {
+  EUserStatus2["ACTIVE"] = "active";
+  EUserStatus2["BLOCKED"] = "blocked";
+  return EUserStatus2;
+})(EUserStatus || {});
+var ESortDir = /* @__PURE__ */ ((ESortDir2) => {
+  ESortDir2["ASC"] = "ASC";
+  ESortDir2["DESC"] = "DESC";
+  return ESortDir2;
+})(ESortDir || {});
+
+// src/dto/auth/index.ts
+var auth_exports = {};
+
+// src/interfaces/common/index.ts
+var common_exports = {};
+
+// src/interfaces/models/index.ts
+var models_exports = {};
+
+// src/core/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  createErrorResponse: () => createErrorResponse,
+  createSuccessResponse: () => createSuccessResponse,
+  joinApiPath: () => joinApiPath
+});
+function createSuccessResponse(data, meta = {}) {
+  return {
+    statusCode: meta.statusCode ?? 200,
+    message: meta.message ?? "Success",
+    data,
+    timestamp: meta.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function createErrorResponse(input) {
+  return {
+    statusCode: input.statusCode ?? 500,
+    error: input.error,
+    message: input.message,
+    path: input.path,
+    timestamp: input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+    ...input.code === void 0 ? {} : { code: input.code },
+    ...input.details === void 0 ? {} : { details: input.details }
+  };
+}
+function joinApiPath(...parts) {
+  const values = parts.filter((part) => part !== null && part !== void 0);
+  if (values.length === 0) return "";
+  return values.map((part, index) => {
+    const value = String(part);
+    return index === 0 ? value.replace(/\/+$/g, "") : value.replace(/^\/+|\/+$/g, "");
+  }).filter(Boolean).join("/");
+}
+
+// src/core/auth/index.ts
+var auth_exports2 = {};
+__export(auth_exports2, {
+  AuthMode: () => AuthMode
+});
+var AuthMode = { JWT: "jwt", SESSION: "session" };
+
+// src/core/errors/index.ts
+var errors_exports = {};
+__export(errors_exports, {
+  CoreError: () => CoreError,
+  CoreErrorCode: () => CoreErrorCode,
+  isCoreError: () => isCoreError
+});
+var CoreErrorCode = {
+  VALIDATION: "VALIDATION",
+  UNAUTHENTICATED: "UNAUTHENTICATED",
+  FORBIDDEN: "FORBIDDEN",
+  NOT_FOUND: "NOT_FOUND",
+  CONFLICT: "CONFLICT",
+  RATE_LIMITED: "RATE_LIMITED",
+  UNAVAILABLE: "UNAVAILABLE",
+  INTERNAL: "INTERNAL"
+};
+var CoreError = class extends Error {
+  constructor(options) {
+    super(options.message);
+    this.name = "CoreError";
+    this.code = options.code;
+    this.details = options.details;
+    this.cause = options.cause;
+  }
+};
+function isCoreError(error) {
+  return error instanceof CoreError;
+}
+
+// src/core/pagination/index.ts
+var pagination_exports = {};
+__export(pagination_exports, {
+  createPaginatedResult: () => createPaginatedResult,
+  getPaginationOffset: () => getPaginationOffset,
+  normalizePagination: () => normalizePagination
+});
+function normalizePagination(input, policy = {}) {
+  const defaultPage = positiveInteger(policy.defaultPage, 1);
+  const defaultLimit = positiveInteger(policy.defaultLimit, 20);
+  const maxLimit = positiveInteger(policy.maxLimit, 100);
+  return {
+    page: positiveInteger(input.page, defaultPage),
+    limit: Math.min(positiveInteger(input.limit, defaultLimit), maxLimit)
+  };
+}
+function getPaginationOffset(pagination) {
+  return (pagination.page - 1) * pagination.limit;
+}
+function createPaginatedResult(items, totalItems, pagination) {
+  const safeTotal = Math.max(0, Math.trunc(totalItems));
+  const totalPages = safeTotal === 0 ? 0 : Math.ceil(safeTotal / pagination.limit);
+  return {
+    items,
+    totalItems: safeTotal,
+    page: pagination.page,
+    limit: pagination.limit,
+    totalPages,
+    hasNextPage: pagination.page < totalPages,
+    hasPreviousPage: pagination.page > 1 && totalPages > 0
+  };
+}
+function positiveInteger(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : fallback;
+}
+
+// src/core/permissions/index.ts
+var permissions_exports = {};
+__export(permissions_exports, {
+  hasAllPermissions: () => hasAllPermissions,
+  hasAnyPermission: () => hasAnyPermission
+});
+function hasAllPermissions(granted, required) {
+  if (required.length === 0) return true;
+  const values = granted instanceof Set ? granted : new Set(granted);
+  return required.every((permission) => values.has(permission));
+}
+function hasAnyPermission(granted, required) {
+  if (required.length === 0) return true;
+  const values = granted instanceof Set ? granted : new Set(granted);
+  return required.some((permission) => values.has(permission));
+}
+
+// src/core/ports/index.ts
+var ports_exports = {};
+__export(ports_exports, {
+  systemClock: () => systemClock
+});
+var systemClock = { now: () => /* @__PURE__ */ new Date() };
+
+// src/core/result/index.ts
+var result_exports = {};
+__export(result_exports, {
+  err: () => err,
+  isErr: () => isErr,
+  isOk: () => isOk,
+  mapResult: () => mapResult,
+  ok: () => ok,
+  unwrapResult: () => unwrapResult
+});
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok;
+}
+function isErr(result) {
+  return !result.ok;
+}
+function unwrapResult(result) {
+  if (result.ok) return result.value;
+  throw result.error;
+}
+function mapResult(result, mapper) {
+  return result.ok ? ok(mapper(result.value)) : result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  API_ACTIONS,
+  API_CONTROLLERS,
+  API_VERSION,
+  AuthMode,
+  CoreError,
+  CoreErrorCode,
+  ESortDir,
+  EUserStatus,
+  MeagoApi,
+  MeagoAuth,
+  MeagoConstants,
+  MeagoDto,
+  MeagoEnums,
+  MeagoErrors,
+  MeagoInterfacesCommon,
+  MeagoInterfacesModels,
+  MeagoPagination,
+  MeagoPermissions,
+  MeagoPorts,
+  MeagoResult,
+  PERMISSIONS,
+  createErrorResponse,
+  createPaginatedResult,
+  createSuccessResponse,
+  err,
+  getPaginationOffset,
+  hasAllPermissions,
+  hasAnyPermission,
+  isCoreError,
+  isErr,
+  isOk,
+  joinApiPath,
+  mapResult,
+  normalizePagination,
+  ok,
+  systemClock,
+  unwrapResult
+});

package/dist/index.mjs

@@ -0,0 +1,271 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/constants/index.ts
+var constants_exports = {};
+__export(constants_exports, {
+  API_ACTIONS: () => API_ACTIONS,
+  API_CONTROLLERS: () => API_CONTROLLERS,
+  API_VERSION: () => API_VERSION,
+  PERMISSIONS: () => PERMISSIONS
+});
+var API_VERSION = "/api/v1";
+var API_CONTROLLERS = {
+  AUTH: "auth",
+  USERS: "users",
+  ROLES: "roles",
+  STORIES: "stories"
+};
+var API_ACTIONS = {
+  LOGIN: "login",
+  REGISTER: "register",
+  REFRESH: "refresh",
+  LOGOUT: "logout",
+  LOGOUT_ALL: "logout-all",
+  ME: "me"
+};
+var PERMISSIONS = {
+  USER: {
+    READ: "user:read",
+    MANAGE: "user:manage"
+  },
+  ROLE: {
+    READ: "role:read",
+    MANAGE: "role:manage"
+  },
+  STORY: {
+    CREATE: "story:create",
+    READ: "story:read",
+    MANAGE: "story:manage"
+  }
+};
+
+// src/enums/index.ts
+var enums_exports = {};
+__export(enums_exports, {
+  ESortDir: () => ESortDir,
+  EUserStatus: () => EUserStatus
+});
+var EUserStatus = /* @__PURE__ */ ((EUserStatus2) => {
+  EUserStatus2["ACTIVE"] = "active";
+  EUserStatus2["BLOCKED"] = "blocked";
+  return EUserStatus2;
+})(EUserStatus || {});
+var ESortDir = /* @__PURE__ */ ((ESortDir2) => {
+  ESortDir2["ASC"] = "ASC";
+  ESortDir2["DESC"] = "DESC";
+  return ESortDir2;
+})(ESortDir || {});
+
+// src/dto/auth/index.ts
+var auth_exports = {};
+
+// src/interfaces/common/index.ts
+var common_exports = {};
+
+// src/interfaces/models/index.ts
+var models_exports = {};
+
+// src/core/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  createErrorResponse: () => createErrorResponse,
+  createSuccessResponse: () => createSuccessResponse,
+  joinApiPath: () => joinApiPath
+});
+function createSuccessResponse(data, meta = {}) {
+  return {
+    statusCode: meta.statusCode ?? 200,
+    message: meta.message ?? "Success",
+    data,
+    timestamp: meta.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function createErrorResponse(input) {
+  return {
+    statusCode: input.statusCode ?? 500,
+    error: input.error,
+    message: input.message,
+    path: input.path,
+    timestamp: input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+    ...input.code === void 0 ? {} : { code: input.code },
+    ...input.details === void 0 ? {} : { details: input.details }
+  };
+}
+function joinApiPath(...parts) {
+  const values = parts.filter((part) => part !== null && part !== void 0);
+  if (values.length === 0) return "";
+  return values.map((part, index) => {
+    const value = String(part);
+    return index === 0 ? value.replace(/\/+$/g, "") : value.replace(/^\/+|\/+$/g, "");
+  }).filter(Boolean).join("/");
+}
+
+// src/core/auth/index.ts
+var auth_exports2 = {};
+__export(auth_exports2, {
+  AuthMode: () => AuthMode
+});
+var AuthMode = { JWT: "jwt", SESSION: "session" };
+
+// src/core/errors/index.ts
+var errors_exports = {};
+__export(errors_exports, {
+  CoreError: () => CoreError,
+  CoreErrorCode: () => CoreErrorCode,
+  isCoreError: () => isCoreError
+});
+var CoreErrorCode = {
+  VALIDATION: "VALIDATION",
+  UNAUTHENTICATED: "UNAUTHENTICATED",
+  FORBIDDEN: "FORBIDDEN",
+  NOT_FOUND: "NOT_FOUND",
+  CONFLICT: "CONFLICT",
+  RATE_LIMITED: "RATE_LIMITED",
+  UNAVAILABLE: "UNAVAILABLE",
+  INTERNAL: "INTERNAL"
+};
+var CoreError = class extends Error {
+  constructor(options) {
+    super(options.message);
+    this.name = "CoreError";
+    this.code = options.code;
+    this.details = options.details;
+    this.cause = options.cause;
+  }
+};
+function isCoreError(error) {
+  return error instanceof CoreError;
+}
+
+// src/core/pagination/index.ts
+var pagination_exports = {};
+__export(pagination_exports, {
+  createPaginatedResult: () => createPaginatedResult,
+  getPaginationOffset: () => getPaginationOffset,
+  normalizePagination: () => normalizePagination
+});
+function normalizePagination(input, policy = {}) {
+  const defaultPage = positiveInteger(policy.defaultPage, 1);
+  const defaultLimit = positiveInteger(policy.defaultLimit, 20);
+  const maxLimit = positiveInteger(policy.maxLimit, 100);
+  return {
+    page: positiveInteger(input.page, defaultPage),
+    limit: Math.min(positiveInteger(input.limit, defaultLimit), maxLimit)
+  };
+}
+function getPaginationOffset(pagination) {
+  return (pagination.page - 1) * pagination.limit;
+}
+function createPaginatedResult(items, totalItems, pagination) {
+  const safeTotal = Math.max(0, Math.trunc(totalItems));
+  const totalPages = safeTotal === 0 ? 0 : Math.ceil(safeTotal / pagination.limit);
+  return {
+    items,
+    totalItems: safeTotal,
+    page: pagination.page,
+    limit: pagination.limit,
+    totalPages,
+    hasNextPage: pagination.page < totalPages,
+    hasPreviousPage: pagination.page > 1 && totalPages > 0
+  };
+}
+function positiveInteger(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : fallback;
+}
+
+// src/core/permissions/index.ts
+var permissions_exports = {};
+__export(permissions_exports, {
+  hasAllPermissions: () => hasAllPermissions,
+  hasAnyPermission: () => hasAnyPermission
+});
+function hasAllPermissions(granted, required) {
+  if (required.length === 0) return true;
+  const values = granted instanceof Set ? granted : new Set(granted);
+  return required.every((permission) => values.has(permission));
+}
+function hasAnyPermission(granted, required) {
+  if (required.length === 0) return true;
+  const values = granted instanceof Set ? granted : new Set(granted);
+  return required.some((permission) => values.has(permission));
+}
+
+// src/core/ports/index.ts
+var ports_exports = {};
+__export(ports_exports, {
+  systemClock: () => systemClock
+});
+var systemClock = { now: () => /* @__PURE__ */ new Date() };
+
+// src/core/result/index.ts
+var result_exports = {};
+__export(result_exports, {
+  err: () => err,
+  isErr: () => isErr,
+  isOk: () => isOk,
+  mapResult: () => mapResult,
+  ok: () => ok,
+  unwrapResult: () => unwrapResult
+});
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok;
+}
+function isErr(result) {
+  return !result.ok;
+}
+function unwrapResult(result) {
+  if (result.ok) return result.value;
+  throw result.error;
+}
+function mapResult(result, mapper) {
+  return result.ok ? ok(mapper(result.value)) : result;
+}
+export {
+  API_ACTIONS,
+  API_CONTROLLERS,
+  API_VERSION,
+  AuthMode,
+  CoreError,
+  CoreErrorCode,
+  ESortDir,
+  EUserStatus,
+  api_exports as MeagoApi,
+  auth_exports2 as MeagoAuth,
+  constants_exports as MeagoConstants,
+  auth_exports as MeagoDto,
+  enums_exports as MeagoEnums,
+  errors_exports as MeagoErrors,
+  common_exports as MeagoInterfacesCommon,
+  models_exports as MeagoInterfacesModels,
+  pagination_exports as MeagoPagination,
+  permissions_exports as MeagoPermissions,
+  ports_exports as MeagoPorts,
+  result_exports as MeagoResult,
+  PERMISSIONS,
+  createErrorResponse,
+  createPaginatedResult,
+  createSuccessResponse,
+  err,
+  getPaginationOffset,
+  hasAllPermissions,
+  hasAnyPermission,
+  isCoreError,
+  isErr,
+  isOk,
+  joinApiPath,
+  mapResult,
+  normalizePagination,
+  ok,
+  systemClock,
+  unwrapResult
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@meago/core",
+  "version": "0.2.0",
+  "description": "Framework-neutral contracts and core primitives for Meago applications",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "check": "tsc --noEmit",
+    "check:watch": "tsc --noEmit --watch",
+    "test": "node scripts/smoke.mjs",
+    "pack:check": "npm pack --dry-run --cache .npm-cache",
+    "verify": "npm run check && npm run build && npm run test && npm run pack:check",
+    "pub": "npm run build && npm publish"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "author": "Meago",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}