kfreelance-project-postgresql-prisma-2 0.0.1

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 --access public
+```
+
+## 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,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaClient = void 0;
+// Direct client export for simple usage
+var index_js_1 = require("../generated/prisma/index.js");
+Object.defineProperty(exports, "PrismaClient", { enumerable: true, get: function () { return index_js_1.PrismaClient; } });
+//# 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,yDAA4D;AAAnD,wGAAA,YAAY,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { PrismaClient } from "../generated/prisma";
+export type { Prisma, User } from "../generated/prisma";
+export declare const getDefaultDatabaseUrl: () => string;
+export declare const createPrismaClient: (options?: {
+    databaseUrl?: string;
+    log?: Array<"query" | "info" | "warn" | "error">;
+}) => any;
+import { PrismaClient } from "../generated/prisma";
+export default PrismaClient;
+//# 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,qBAAqB,CAAC;AACnD,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGxD,eAAO,MAAM,qBAAqB,cAKjC,CAAC;AAGF,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,QAWA,CAAC;AAGF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrismaClient = exports.getDefaultDatabaseUrl = exports.PrismaClient = void 0;
+// Export Prisma Client and types
+var prisma_1 = require("../generated/prisma");
+Object.defineProperty(exports, "PrismaClient", { enumerable: true, get: function () { return prisma_1.PrismaClient; } });
+// Default database URL helper
+const getDefaultDatabaseUrl = () => {
+    return (process.env.DATABASE_URL ||
+        "postgresql://postgres:password@localhost:5432/freelance_db");
+};
+exports.getDefaultDatabaseUrl = getDefaultDatabaseUrl;
+// Factory function to create Prisma client with custom options
+const createPrismaClient = (options) => {
+    const { PrismaClient } = require("../generated/prisma");
+    return new PrismaClient({
+        datasources: {
+            db: {
+                url: options?.databaseUrl || (0, exports.getDefaultDatabaseUrl)(),
+            },
+        },
+        log: options?.log || ["error", "warn"],
+    });
+};
+exports.createPrismaClient = createPrismaClient;
+// Default export for convenience
+const prisma_2 = require("../generated/prisma");
+exports.default = prisma_2.PrismaClient;
+//# 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,iCAAiC;AACjC,8CAAmD;AAA1C,sGAAA,YAAY,OAAA;AAGrB,8BAA8B;AACvB,MAAM,qBAAqB,GAAG,GAAG,EAAE;IACxC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,YAAY;QACxB,4DAA4D,CAC7D,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,qBAAqB,yBAKhC;AAEF,+DAA+D;AACxD,MAAM,kBAAkB,GAAG,CAAC,OAGlC,EAAE,EAAE;IACH,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAExD,OAAO,IAAI,YAAY,CAAC;QACtB,WAAW,EAAE;YACX,EAAE,EAAE;gBACF,GAAG,EAAE,OAAO,EAAE,WAAW,IAAI,IAAA,6BAAqB,GAAE;aACrD;SACF;QACD,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;KACvC,CAAC,CAAC;AACL,CAAC,CAAC;AAdW,QAAA,kBAAkB,sBAc7B;AAEF,iCAAiC;AACjC,gDAAmD;AACnD,kBAAe,qBAAY,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"