kfreelance-project-postgresql-prisma 1.0.0

package/README.MD

@@ -0,0 +1,217 @@
+# kfreelance-project-postgresql-prisma
+
+A shared Prisma client library for microservices, providing a centralized database schema and ORM functionality.
+
+## Installation
+
+```bash
+npm install kfreelance-project-postgresql-prisma
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { PrismaClient } from 'kfreelance-project-postgresql-prisma';
+
+const prisma = new PrismaClient();
+
+async function main() {
+  // Create a user
+  const user = await prisma.user.create({
+    data: {
+      username: 'john_doe',
+      email: 'john@example.com',
+      passwordHash: 'hashed_password_here',
+      is_active: true,
+      must_reset_password: false,
+    },
+  });
+
+  // Find all users
+  const users = await prisma.user.findMany();
+  console.log(users);
+}
+
+main()
+  .then(async () => {
+    await prisma.$disconnect();
+  })
+  .catch(async (e) => {
+    console.error(e);
+    await prisma.$disconnect();
+    process.exit(1);
+  });
+```
+
+### Using Custom Database URL
+
+```typescript
+import { createPrismaClient } from 'kfreelance-project-postgresql-prisma';
+
+const prisma = createPrismaClient({
+  databaseUrl: 'postgresql://user:password@localhost:5432/mydb',
+  log: ['query', 'error'],
+});
+```
+
+### Direct Client Import (Alternative)
+
+```typescript
+import { PrismaClient } from 'kfreelance-project-postgresql-prisma/client';
+
+const prisma = new PrismaClient();
+```
+
+## Environment Variables
+
+Set the following environment variable in your microservice:
+
+```bash
+DATABASE_URL="postgresql://postgres:your_secure_password@localhost:5432/freelance_db?schema=public"
+```
+
+## Available Types
+
+The library exports all Prisma-generated types:
+
+```typescript
+import type { User, PasswordResetToken, Prisma } from 'kfreelance-project-postgresql-prisma';
+
+// Use types for function parameters
+function createUser(userData: Prisma.UserCreateInput): Promise<User> {
+  return prisma.user.create({ data: userData });
+}
+```
+
+## Database Schema
+
+The library includes the following models:
+
+### User
+- `id`: String (UUID)
+- `username`: String (unique)
+- `email`: String (unique)
+- `passwordHash`: String
+- `is_active`: Boolean
+- `must_reset_password`: Boolean
+- `created_at`: DateTime
+- `updated_at`: DateTime
+
+### PasswordResetToken
+- `id`: String (UUID)
+- `user_id`: String (foreign key to User)
+- `reset_token`: String (hashed)
+- `expires_at`: DateTime
+- `used`: Boolean
+
+## Utility Functions
+
+### `createPrismaClient(options?)`
+
+Create a PrismaClient instance with custom configuration:
+
+```typescript
+const prisma = createPrismaClient({
+  databaseUrl: 'your-custom-database-url',
+  log: ['query', 'info', 'warn', 'error'], // Optional logging
+});
+```
+
+### `getDefaultDatabaseUrl()`
+
+Get the default database URL (useful for debugging):
+
+```typescript
+import { getDefaultDatabaseUrl } from 'kfreelance-project-postgresql-prisma';
+
+console.log('Using database:', getDefaultDatabaseUrl());
+```
+
+## Development
+
+If you're working on this library:
+
+```bash
+# Install dependencies
+npm install
+
+# Copy environment file
+cp .env.example .env
+
+# Generate Prisma client
+npm run generate
+
+# Build the library
+npm run build
+
+# Run development example
+npm run dev
+```
+
+## Publishing
+
+To publish a new version:
+
+```bash
+# Build the library
+npm run build
+
+# Publish to npm
+npm publish
+```
+
+## Integration in Microservices
+
+### 1. Install the library
+```bash
+npm install kfreelance-project-postgresql-prisma
+```
+
+### 2. Set environment variables
+```bash
+# .env
+DATABASE_URL="postgresql://postgres:password@localhost:5432/freelance_db?schema=public"
+```
+
+### 3. Use in your microservice
+```typescript
+import { PrismaClient, type User } from 'kfreelance-project-postgresql-prisma';
+
+const prisma = new PrismaClient();
+
+export class UserService {
+  async findUserById(id: string): Promise<User | null> {
+    return prisma.user.findUnique({ where: { id } });
+  }
+
+  async createUser(userData: {
+    username: string;
+    email: string;
+    passwordHash: string;
+  }): Promise<User> {
+    return prisma.user.create({
+      data: {
+        ...userData,
+        is_active: true,
+        must_reset_password: false,
+      },
+    });
+  }
+}
+```
+
+## Migration Notes
+
+When the database schema changes:
+
+1. Update the Prisma schema in this library
+2. Generate new migrations
+3. Build and publish a new version
+4. Update the library version in your microservices
+5. Run database migrations
+
+## Support
+
+For issues or questions about this library, please contact the platform team or create an issue in the repository.

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+export { PrismaClient } from "../generated/prisma/index.js";
+export type * from "../generated/prisma/index.js";
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,mBAAmB,8BAA8B,CAAC"}

package/dist/client.js

@@ -0,0 +1,3 @@
+// Direct client export for simple usage
+export { PrismaClient } from "../generated/prisma/index.js";
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { PrismaClient } from "../generated/prisma/index.js";
+export type { User, PasswordResetToken, Prisma, } from "../generated/prisma/index.js";
+import { PrismaClient } from "../generated/prisma/index.js";
+export declare const createPrismaClient: (options?: {
+    databaseUrl?: string;
+    log?: Array<"query" | "info" | "warn" | "error">;
+}) => PrismaClient<import("../generated/prisma/index.js").Prisma.PrismaClientOptions, never, import("../generated/prisma/runtime/library.js").DefaultArgs>;
+export declare const getDefaultDatabaseUrl: () => string;
+//# 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":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,YAAY,EACV,IAAI,EACJ,kBAAkB,EAClB,MAAM,GACP,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,eAAO,MAAM,kBAAkB,GAAI,UAAU;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAClD,yJAgBA,CAAC;AAGF,eAAO,MAAM,qBAAqB,cAEjC,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+// Library entry point - exports PrismaClient and types for consuming microservices
+export { PrismaClient } from "../generated/prisma/index.js";
+import { PrismaClient } from "../generated/prisma/index.js";
+// Utility function to create a PrismaClient with custom options
+export const createPrismaClient = (options) => {
+    const config = {};
+    if (options?.databaseUrl) {
+        config.datasources = {
+            db: {
+                url: options.databaseUrl,
+            },
+        };
+    }
+    if (options?.log) {
+        config.log = options.log;
+    }
+    return new PrismaClient(config);
+};
+// Export database configuration helpers
+export const getDefaultDatabaseUrl = () => {
+    return process.env.DATABASE_URL || "postgresql://postgres:your_secure_password@localhost:5432/freelance_db?schema=public";
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAS5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,gEAAgE;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAGlC,EAAE,EAAE;IACH,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,MAAM,CAAC,WAAW,GAAG;YACnB,EAAE,EAAE;gBACF,GAAG,EAAE,OAAO,CAAC,WAAW;aACzB;SACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,sFAAsF,CAAC;AAC5H,CAAC,CAAC"}

package/generated/prisma/client.d.ts

@@ -0,0 +1 @@
+export * from "./index"

package/generated/prisma/client.js

@@ -0,0 +1,4 @@
+
+/* !!! This is code generated by Prisma. Do not edit directly. !!!
+/* eslint-disable */
+module.exports = { ...require('.') }

package/generated/prisma/default.d.ts

@@ -0,0 +1 @@
+export * from "./index"

package/generated/prisma/default.js

@@ -0,0 +1,4 @@
+
+/* !!! This is code generated by Prisma. Do not edit directly. !!!
+/* eslint-disable */
+module.exports = { ...require('#main-entry-point') }

package/generated/prisma/edge.d.ts

@@ -0,0 +1 @@
+export * from "./default"

package/generated/prisma/edge.js

@@ -0,0 +1,201 @@
+
+/* !!! This is code generated by Prisma. Do not edit directly. !!!
+/* eslint-disable */
+
+Object.defineProperty(exports, "__esModule", { value: true });
+
+const {
+  PrismaClientKnownRequestError,
+  PrismaClientUnknownRequestError,
+  PrismaClientRustPanicError,
+  PrismaClientInitializationError,
+  PrismaClientValidationError,
+  getPrismaClient,
+  sqltag,
+  empty,
+  join,
+  raw,
+  skip,
+  Decimal,
+  Debug,
+  objectEnumValues,
+  makeStrictEnum,
+  Extensions,
+  warnOnce,
+  defineDmmfProperty,
+  Public,
+  getRuntime,
+  createParam,
+} = require('./runtime/edge.js')
+
+
+const Prisma = {}
+
+exports.Prisma = Prisma
+exports.$Enums = {}
+
+/**
+ * Prisma Client JS version: 6.16.3
+ * Query Engine version: bb420e667c1820a8c05a38023385f6cc7ef8e83a
+ */
+Prisma.prismaVersion = {
+  client: "6.16.3",
+  engine: "bb420e667c1820a8c05a38023385f6cc7ef8e83a"
+}
+
+Prisma.PrismaClientKnownRequestError = PrismaClientKnownRequestError;
+Prisma.PrismaClientUnknownRequestError = PrismaClientUnknownRequestError
+Prisma.PrismaClientRustPanicError = PrismaClientRustPanicError
+Prisma.PrismaClientInitializationError = PrismaClientInitializationError
+Prisma.PrismaClientValidationError = PrismaClientValidationError
+Prisma.Decimal = Decimal
+
+/**
+ * Re-export of sql-template-tag
+ */
+Prisma.sql = sqltag
+Prisma.empty = empty
+Prisma.join = join
+Prisma.raw = raw
+Prisma.validator = Public.validator
+
+/**
+* Extensions
+*/
+Prisma.getExtensionContext = Extensions.getExtensionContext
+Prisma.defineExtension = Extensions.defineExtension
+
+/**
+ * Shorthand utilities for JSON filtering
+ */
+Prisma.DbNull = objectEnumValues.instances.DbNull
+Prisma.JsonNull = objectEnumValues.instances.JsonNull
+Prisma.AnyNull = objectEnumValues.instances.AnyNull
+
+Prisma.NullTypes = {
+  DbNull: objectEnumValues.classes.DbNull,
+  JsonNull: objectEnumValues.classes.JsonNull,
+  AnyNull: objectEnumValues.classes.AnyNull
+}
+
+
+
+
+
+/**
+ * Enums
+ */
+exports.Prisma.TransactionIsolationLevel = makeStrictEnum({
+  ReadUncommitted: 'ReadUncommitted',
+  ReadCommitted: 'ReadCommitted',
+  RepeatableRead: 'RepeatableRead',
+  Serializable: 'Serializable'
+});
+
+exports.Prisma.UserScalarFieldEnum = {
+  id: 'id',
+  username: 'username',
+  email: 'email',
+  passwordHash: 'passwordHash',
+  is_active: 'is_active',
+  must_reset_password: 'must_reset_password',
+  created_at: 'created_at',
+  updated_at: 'updated_at'
+};
+
+exports.Prisma.PasswordResetTokenScalarFieldEnum = {
+  id: 'id',
+  user_id: 'user_id',
+  reset_token: 'reset_token',
+  expires_at: 'expires_at',
+  used: 'used'
+};
+
+exports.Prisma.SortOrder = {
+  asc: 'asc',
+  desc: 'desc'
+};
+
+exports.Prisma.QueryMode = {
+  default: 'default',
+  insensitive: 'insensitive'
+};
+
+
+exports.Prisma.ModelName = {
+  User: 'User',
+  PasswordResetToken: 'PasswordResetToken'
+};
+/**
+ * Create the Client
+ */
+const config = {
+  "generator": {
+    "name": "client",
+    "provider": {
+      "fromEnvVar": null,
+      "value": "prisma-client-js"
+    },
+    "output": {
+      "value": "/Users/devuser01/Documents/MartinGithub/freelance-project/postgresql-prisma/generated/prisma",
+      "fromEnvVar": null
+    },
+    "config": {
+      "engineType": "library"
+    },
+    "binaryTargets": [
+      {
+        "fromEnvVar": null,
+        "value": "darwin-arm64",
+        "native": true
+      }
+    ],
+    "previewFeatures": [],
+    "sourceFilePath": "/Users/devuser01/Documents/MartinGithub/freelance-project/postgresql-prisma/prisma/schema.prisma",
+    "isCustomOutput": true
+  },
+  "relativeEnvPaths": {
+    "rootEnvPath": null,
+    "schemaEnvPath": "../../.env"
+  },
+  "relativePath": "../../prisma",
+  "clientVersion": "6.16.3",
+  "engineVersion": "bb420e667c1820a8c05a38023385f6cc7ef8e83a",
+  "datasourceNames": [
+    "db"
+  ],
+  "activeProvider": "postgresql",
+  "postinstall": false,
+  "inlineDatasources": {
+    "db": {
+      "url": {
+        "fromEnvVar": "DATABASE_URL",
+        "value": null
+      }
+    }
+  },
+  "inlineSchema": "// This is your Prisma schema file,\n// learn more about it in the docs: https://pris.ly/d/prisma-schema\n\n// Looking for ways to speed up your queries, or scale easily with your serverless or edge functions?\n// Try Prisma Accelerate: https://pris.ly/cli/accelerate-init\n\ngenerator client {\n  provider = \"prisma-client-js\"\n  output   = \"../generated/prisma\"\n}\n\ndatasource db {\n  provider = \"postgresql\"\n  url      = env(\"DATABASE_URL\")\n}\n\nmodel User {\n  id                  String   @id @default(uuid())\n  username            String   @unique\n  email               String   @unique\n  passwordHash        String // Hashed password\n  is_active           Boolean\n  must_reset_password Boolean\n  created_at          DateTime @default(now())\n  updated_at          DateTime @updatedAt\n\n  PasswordResetTokens PasswordResetToken[]\n}\n\nmodel PasswordResetToken {\n  id          String   @id @default(uuid())\n  user        User     @relation(fields: [user_id], references: [id])\n  user_id     String\n  reset_token String // Hashed\n  expires_at  DateTime\n  used        Boolean\n}\n",
+  "inlineSchemaHash": "c4e23dc59763709dd29d03a9006f79e39b1bb63dfdd6af3874fc971c1c262691",
+  "copyEngine": true
+}
+config.dirname = '/'
+
+config.runtimeDataModel = JSON.parse("{\"models\":{\"User\":{\"dbName\":null,\"schema\":null,\"fields\":[{\"name\":\"id\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":true,\"isReadOnly\":false,\"hasDefaultValue\":true,\"type\":\"String\",\"nativeType\":null,\"default\":{\"name\":\"uuid\",\"args\":[4]},\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"username\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":true,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"String\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"email\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":true,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"String\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"passwordHash\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"String\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"is_active\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"Boolean\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"must_reset_password\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"Boolean\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"created_at\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":true,\"type\":\"DateTime\",\"nativeType\":null,\"default\":{\"name\":\"now\",\"args\":[]},\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"updated_at\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"DateTime\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":true},{\"name\":\"PasswordResetTokens\",\"kind\":\"object\",\"isList\":true,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"PasswordResetToken\",\"nativeType\":null,\"relationName\":\"PasswordResetTokenToUser\",\"relationFromFields\":[],\"relationToFields\":[],\"isGenerated\":false,\"isUpdatedAt\":false}],\"primaryKey\":null,\"uniqueFields\":[],\"uniqueIndexes\":[],\"isGenerated\":false},\"PasswordResetToken\":{\"dbName\":null,\"schema\":null,\"fields\":[{\"name\":\"id\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":true,\"isReadOnly\":false,\"hasDefaultValue\":true,\"type\":\"String\",\"nativeType\":null,\"default\":{\"name\":\"uuid\",\"args\":[4]},\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"user\",\"kind\":\"object\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"User\",\"nativeType\":null,\"relationName\":\"PasswordResetTokenToUser\",\"relationFromFields\":[\"user_id\"],\"relationToFields\":[\"id\"],\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"user_id\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":true,\"hasDefaultValue\":false,\"type\":\"String\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"reset_token\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"String\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"expires_at\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"DateTime\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false},{\"name\":\"used\",\"kind\":\"scalar\",\"isList\":false,\"isRequired\":true,\"isUnique\":false,\"isId\":false,\"isReadOnly\":false,\"hasDefaultValue\":false,\"type\":\"Boolean\",\"nativeType\":null,\"isGenerated\":false,\"isUpdatedAt\":false}],\"primaryKey\":null,\"uniqueFields\":[],\"uniqueIndexes\":[],\"isGenerated\":false}},\"enums\":{},\"types\":{}}")
+defineDmmfProperty(exports.Prisma, config.runtimeDataModel)
+config.engineWasm = undefined
+config.compilerWasm = undefined
+
+config.injectableEdgeEnv = () => ({
+  parsed: {
+    DATABASE_URL: typeof globalThis !== 'undefined' && globalThis['DATABASE_URL'] || typeof process !== 'undefined' && process.env && process.env.DATABASE_URL || undefined
+  }
+})
+
+if (typeof globalThis !== 'undefined' && globalThis['DEBUG'] || typeof process !== 'undefined' && process.env && process.env.DEBUG || undefined) {
+  Debug.enable(typeof globalThis !== 'undefined' && globalThis['DEBUG'] || typeof process !== 'undefined' && process.env && process.env.DEBUG || undefined)
+}
+
+const PrismaClient = getPrismaClient(config)
+exports.PrismaClient = PrismaClient
+Object.assign(exports, Prisma)
+