@usequark/quark-core 2.5.4 → 2.5.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024, Quark 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

@@ -1,4 +1,4 @@
-# @techstream/quark-core
+# @usequark/quark-core
 
 Shared infrastructure for the Quark platform - authentication, job queues, error handling, and utilities.
 
@@ -25,7 +25,7 @@ import {
   addJob,
   ValidationError,
   retryAsync,
-} from "@techstream/quark-core";
+} from "@usequark/quark-core";
 ```
 
 All modules are re-exported from the package root. See JSDoc comments on each function for options and usage details.
@@ -36,16 +36,16 @@ Prefer a subpath when you want a smaller import graph or the browser-safe logger
 
 | Subpath | Contents |
 |---|---|
-| `@techstream/quark-core/core` | errors, logger, validation, utils, pagination, csrf, rate limiter, file validation, db |
-| `@techstream/quark-core/db` | Prisma singleton, connection string, pool config, `pingDatabase()` |
-| `@techstream/quark-core/admin` | Prisma schema introspection helpers |
-| `@techstream/quark-core/auth` | auth config helpers + session guards |
-| `@techstream/quark-core/auth/middleware` | session guards only |
-| `@techstream/quark-core/storage` | local adapter, storage factory, key/URL helpers, `createS3Storage` |
-| `@techstream/quark-core/storage/s3` | S3 adapter only |
-| `@techstream/quark-core/logger` | browser-safe logger |
-| `@techstream/quark-core/locale` | locale helpers |
-| `@techstream/quark-core/stripe` | Stripe client + webhook helpers |
+| `@usequark/quark-core/core` | errors, logger, validation, utils, pagination, csrf, rate limiter, file validation, db |
+| `@usequark/quark-core/db` | Prisma singleton, connection string, pool config, `pingDatabase()` |
+| `@usequark/quark-core/admin` | Prisma schema introspection helpers |
+| `@usequark/quark-core/auth` | auth config helpers + session guards |
+| `@usequark/quark-core/auth/middleware` | session guards only |
+| `@usequark/quark-core/storage` | local adapter, storage factory, key/URL helpers, `createS3Storage` |
+| `@usequark/quark-core/storage/s3` | S3 adapter only |
+| `@usequark/quark-core/logger` | browser-safe logger |
+| `@usequark/quark-core/locale` | locale helpers |
+| `@usequark/quark-core/stripe` | Stripe client + webhook helpers |
 
 `@aws-sdk/client-s3`, `@aws-sdk/s3-request-presigner`, `pg`, and `stripe` are optional peer dependencies. They are only loaded when the matching feature is used, so apps that do not use S3, `pingDatabase()`, or payments do not need them installed.
 

package/package.json

@@ -1,80 +1,92 @@
 {
-	"name": "@usequark/quark-core",
-	"version": "2.5.4",
-	"description": "Core utilities for Quark apps: auth, BullMQ queues, Redis, email, storage, rate limiting, logging, and error handling",
-	"type": "module",
-	"main": "src/index.js",
-	"homepage": "https://github.com/usequark/quark#readme",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/usequark/quark.git",
-		"directory": "packages/core"
-	},
-	"bugs": {
-		"url": "https://github.com/usequark/quark/issues"
-	},
-	"author": "Quark Contributors",
-	"exports": {
-		".": "./src/index.js",
-		"./core": "./src/core.js",
-		"./admin": "./src/admin.js",
-		"./auth": "./src/auth/index.js",
-		"./auth/middleware": "./src/auth/middleware.js",
-		"./db": "./src/db.js",
-		"./email": "./src/email.js",
-		"./errors": "./src/errors.js",
-		"./locale": "./src/locale.js",
-		"./logger": "./src/logger.js",
-		"./metrics": "./src/metrics.js",
-		"./queue": "./src/queue/index.js",
-		"./sms": "./src/sms.js",
-		"./storage": "./src/storage.js",
-		"./storage/s3": "./src/storage-s3.js",
-		"./stripe": "./src/stripe.js",
-		"./testing": "./src/testing/index.js"
-	},
-	"dependencies": {
-		"bcryptjs": "^3.0.3",
-		"busboy": "^1.6.0",
-		"bullmq": "^6.3.8",
-		"ioredis": "^6.0.0",
-		"nodemailer": "^10.0.10",
-		"zod": "^4.6.5"
-	},
-	"peerDependencies": {
-		"@aws-sdk/client-s3": "^3.1004.0",
-		"@aws-sdk/s3-request-presigner": "^3.1004.0",
-		"pg": "^8.20.0",
-		"stripe": "^17.0.0"
-	},
-	"peerDependenciesMeta": {
-		"@aws-sdk/client-s3": {
-			"optional": true
-		},
-		"@aws-sdk/s3-request-presigner": {
-			"optional": true
-		},
-		"pg": {
-			"optional": true
-		},
-		"stripe": {
-			"optional": true
-		}
-	},
-	"devDependencies": {
-		"@types/node": "^26.6.2"
-	},
-	"scripts": {
-		"test": "node ../../scripts/run-tests.mjs src",
-		"lint": "biome format --write && biome check --write"
-	},
-	"files": [
-		"src",
-		"README.md"
-	],
-	"publishConfig": {
-		"registry": "https://registry.npmjs.org",
-		"access": "public"
-	},
-	"license": "MIT"
-}
+  "name": "@usequark/quark-core",
+  "version": "2.5.6",
+  "description": "Core utilities for Quark apps: auth, BullMQ queues, Redis, email, storage, rate limiting, logging, and error handling",
+  "keywords": [
+    "quark",
+    "nextjs",
+    "auth",
+    "bullmq",
+    "redis",
+    "email",
+    "storage",
+    "rate-limiting",
+    "logging",
+    "zod"
+  ],
+  "type": "module",
+  "main": "src/index.js",
+  "homepage": "https://github.com/usequark/quark#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/usequark/quark.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/usequark/quark/issues"
+  },
+  "author": "Quark Contributors",
+  "exports": {
+    ".": "./src/index.js",
+    "./core": "./src/core.js",
+    "./admin": "./src/admin.js",
+    "./auth": "./src/auth/index.js",
+    "./auth/middleware": "./src/auth/middleware.js",
+    "./db": "./src/db.js",
+    "./email": "./src/email.js",
+    "./errors": "./src/errors.js",
+    "./locale": "./src/locale.js",
+    "./logger": "./src/logger.js",
+    "./metrics": "./src/metrics.js",
+    "./queue": "./src/queue/index.js",
+    "./sms": "./src/sms.js",
+    "./storage": "./src/storage.js",
+    "./storage/s3": "./src/storage-s3.js",
+    "./stripe": "./src/stripe.js",
+    "./testing": "./src/testing/index.js"
+  },
+  "dependencies": {
+    "bcryptjs": "^3.0.3",
+    "busboy": "^1.6.0",
+    "bullmq": "^6.3.8",
+    "ioredis": "^6.0.0",
+    "nodemailer": "^10.0.10",
+    "zod": "^4.6.5"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.1004.0",
+    "@aws-sdk/s3-request-presigner": "^3.1004.0",
+    "pg": "^8.20.0",
+    "stripe": "^17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "stripe": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.2"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test": "node ../../scripts/run-tests.mjs src",
+    "lint": "biome format --write && biome check --write"
+  }
+}

package/src/admin-auth.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core — Admin Authorization Module
+ * @usequark/quark-core — Admin Authorization Module
  *
  * Lightweight, stateless admin-token authorization for drop-in internal
  * endpoints (health checks, metrics, admin APIs).
@@ -72,7 +72,7 @@ export function verifyAdminToken(providedToken) {
  *
  * Usage in an API route:
  *
- *   import { requireAdminToken } from "@techstream/quark-core";
+ *   import { requireAdminToken } from "@usequark/quark-core";
  *   import { NextResponse } from "next/server";
  *
  *   export async function GET(request) {

package/src/admin.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Prisma Schema Introspection
+ * @usequark/quark-core - Prisma Schema Introspection
  *
  * Hand-rolled Prisma schema parser that reads `.prisma` files and
  * extracts model and enum definitions.  Used by the admin CRUD layer
@@ -10,7 +10,7 @@
  * where those packages are unavailable.
  *
  * Usage:
- *   import { parseSchema, getModelByName, detectIdField, coerceId } from "@techstream/quark-core/admin";
+ *   import { parseSchema, getModelByName, detectIdField, coerceId } from "@usequark/quark-core/admin";
  */
 
 import { existsSync, readFileSync } from "node:fs";

package/src/auth/index.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Authentication Module
+ * @usequark/quark-core - Authentication Module
  * Provides next-auth initialization and session management helpers
  */
 

package/src/auth/middleware.js

@@ -1,12 +1,12 @@
 /**
- * @techstream/quark-core - Auth Middleware
+ * @usequark/quark-core - Auth Middleware
  *
  * Lightweight, framework-agnostic authentication middleware for Server
  * Actions and API routes.  The caller supplies a `getSession` function
  * (e.g. NextAuth's `auth()`) — this module adds the guard logic.
  *
  * Usage:
- *   import { requireSession, requireSessionRole, createAuthMiddleware } from "@techstream/quark-core/auth/middleware";
+ *   import { requireSession, requireSessionRole, createAuthMiddleware } from "@usequark/quark-core/auth/middleware";
  *
  *   // In a Server Action:
  *   const session = await requireSession(() => auth());

package/src/authorization.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Authorization Module
+ * @usequark/quark-core - Authorization Module
  * Policy-based, schema-agnostic RBAC engine
  */
 

package/src/core.js

@@ -1,12 +1,12 @@
 /**
- * @techstream/quark-core - Core Barrel (Lightweight Utilities)
+ * @usequark/quark-core - Core Barrel (Lightweight Utilities)
  *
  * A smaller entry-point that exposes only the modules with zero or
  * minimal transitive dependencies: errors, logger, validation, utils,
  * pagination, csrf, rate-limiter, file-validation, and db.
  *
  * Downstream projects that only need these utilities can import from
- * "@techstream/quark-core/core" to avoid pulling in heavier modules
+ * "@usequark/quark-core/core" to avoid pulling in heavier modules
  * like email, storage, queue, or metrics.
  */
 

package/src/csrf.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - CSRF Protection Module
+ * @usequark/quark-core - CSRF Protection Module
  * Provides CSRF token generation and validation for API routes
  */
 

package/src/db-instrumentation.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core — Database Instrumentation Module
+ * @usequark/quark-core — Database Instrumentation Module
  *
  * Schema-agnostic Prisma $extends middleware that monitors query execution
  * times and logs slow queries. All query arguments are automatically masked
@@ -10,7 +10,7 @@
  *
  * Usage in client.js:
  *
- *   import { createDbInstrumentation } from "@techstream/quark-core";
+ *   import { createDbInstrumentation } from "@usequark/quark-core";
  *   const base = new PrismaClient({ ... });
  *   const ext = createDbInstrumentation();
  *   if (ext) prisma = base.$extends(ext);

package/src/db-metrics.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core — Database Metrics Registry
+ * @usequark/quark-core — Database Metrics Registry
  *
  * Pre-registered Prometheus metrics for database query instrumentation.
  * Imported lazily by db-instrumentation.js to avoid circular dependencies.

package/src/db.js

@@ -1,12 +1,12 @@
 /**
- * @techstream/quark-core - Database Utilities
+ * @usequark/quark-core - Database Utilities
  *
  * Shared Prisma client singleton, connection-string builder, pool config,
  * and a lightweight health-check ping.  These replace the per-project
  * re-implementations in Regina / Pawdora / Trenchmate.
  *
  * Usage:
- *   import { createPrismaClient, getConnectionString, pingDatabase } from "@techstream/quark-core/db";
+ *   import { createPrismaClient, getConnectionString, pingDatabase } from "@usequark/quark-core/db";
  */
 
 // ---------------------------------------------------------------------------

package/src/email-templates.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Email Templates
+ * @usequark/quark-core - Email Templates
  *
  * Reusable HTML email templates with plain-text fallbacks.
  * Each template function returns { subject, html, text }.

package/src/email.js

@@ -1,12 +1,12 @@
 /**
- * @techstream/quark-core - Email Service
+ * @usequark/quark-core - Email Service
  *
  * Providers are defined using a Strategy Pattern - each implements the same
  * interface. Quark ships with three built-in providers (smtp, resend, zeptomail)
  * and exposes a registry so users can plug in any provider they need.
  *
  * @example Custom provider
- *   import { EmailProvider, registerEmailProvider } from "@techstream/quark-core";
+ *   import { EmailProvider, registerEmailProvider } from "@usequark/quark-core";
  *
  *   class SendGridProvider extends EmailProvider {
  *     async sendEmail(to, subject, html, text) { ... }

package/src/error-reporter.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Error Reporter Module
+ * @usequark/quark-core - Error Reporter Module
  * Adapter/hook system for pluggable error reporting
  */
 
@@ -217,7 +217,7 @@ export class ErrorReporter {
  * @example
  * ```js
  * import * as Sentry from "@sentry/node";
- * import { errorReporter, createSentryAdapter } from "@techstream/quark-core";
+ * import { errorReporter, createSentryAdapter } from "@usequark/quark-core";
  *
  * Sentry.init({ dsn: "https://example@sentry.io/123" });
  * errorReporter.use(createSentryAdapter({ Sentry }));

package/src/errors.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Error Handling Module
+ * @usequark/quark-core - Error Handling Module
  * Standardized error types and utilities for consistent error handling
  */
 

package/src/exports.test.js

@@ -2,34 +2,34 @@ import assert from "node:assert/strict";
 import { readFileSync } from "node:fs";
 import test from "node:test";
 
-import * as core from "@techstream/quark-core";
-import * as admin from "@techstream/quark-core/admin";
-import * as auth from "@techstream/quark-core/auth";
-import * as authMiddleware from "@techstream/quark-core/auth/middleware";
-import * as coreLight from "@techstream/quark-core/core";
-import * as db from "@techstream/quark-core/db";
-import * as email from "@techstream/quark-core/email";
-import * as errors from "@techstream/quark-core/errors";
-import * as locale from "@techstream/quark-core/locale";
-import * as logger from "@techstream/quark-core/logger";
-import * as metrics from "@techstream/quark-core/metrics";
-import * as queue from "@techstream/quark-core/queue";
-import * as sms from "@techstream/quark-core/sms";
-import * as storage from "@techstream/quark-core/storage";
-import * as storageS3 from "@techstream/quark-core/storage/s3";
-import * as stripe from "@techstream/quark-core/stripe";
-import * as testing from "@techstream/quark-core/testing";
+import * as core from "@usequark/quark-core";
+import * as admin from "@usequark/quark-core/admin";
+import * as auth from "@usequark/quark-core/auth";
+import * as authMiddleware from "@usequark/quark-core/auth/middleware";
+import * as coreLight from "@usequark/quark-core/core";
+import * as db from "@usequark/quark-core/db";
+import * as email from "@usequark/quark-core/email";
+import * as errors from "@usequark/quark-core/errors";
+import * as locale from "@usequark/quark-core/locale";
+import * as logger from "@usequark/quark-core/logger";
+import * as metrics from "@usequark/quark-core/metrics";
+import * as queue from "@usequark/quark-core/queue";
+import * as sms from "@usequark/quark-core/sms";
+import * as storage from "@usequark/quark-core/storage";
+import * as storageS3 from "@usequark/quark-core/storage/s3";
+import * as stripe from "@usequark/quark-core/stripe";
+import * as testing from "@usequark/quark-core/testing";
 
 const packageJson = JSON.parse(
 	readFileSync(new URL("../package.json", import.meta.url), "utf-8"),
 );
 
 // Guard against accidental subpath removals: every entry in the exports map
-// must resolve. apps/web imports `@techstream/quark-core/logger`, and the
+// must resolve. apps/web imports `@usequark/quark-core/logger`, and the
 // scaffolded i18n/payment skills document `./locale` and `./stripe`.
 test("every subpath in package.json exports resolves", async () => {
 	for (const subpath of Object.keys(packageJson.exports)) {
-		const specifier = `@techstream/quark-core${
+		const specifier = `@usequark/quark-core${
 			subpath === "." ? "" : subpath.slice(1)
 		}`;
 		await assert.doesNotReject(

package/src/file-validation.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - File Validation
+ * @usequark/quark-core - File Validation
  *
  * Validates uploaded files: size limits, MIME type allow-lists,
  * and magic-byte verification to prevent MIME spoofing.

package/src/index.js

@@ -54,5 +54,5 @@ export * from "./storage.js";
 export * from "./utils.js";
 export * from "./validation.js";
 
-// Testing utilities (import from "@techstream/quark-core/testing" in test files)
+// Testing utilities (import from "@usequark/quark-core/testing" in test files)
 // Not re-exported from main to avoid polluting production imports

package/src/logger.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Logger Module
+ * @usequark/quark-core - Logger Module
  * Lightweight structured logger with zero external dependencies
  */
 

package/src/metrics.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Metrics Module
+ * @usequark/quark-core - Metrics Module
  * Lightweight application metrics with zero external dependencies.
  * Supports counters, gauges, and histograms with optional labels.
  * Exports Prometheus-compatible text format.

package/src/multipart.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Multipart Parser
+ * @usequark/quark-core - Multipart Parser
  *
  * Stream-based multipart/form-data parsing with early limit enforcement.
  * Works with Next.js App Router Request objects.

package/src/pagination.js

@@ -1,12 +1,12 @@
 /**
- * @techstream/quark-core - Pagination Utilities
+ * @usequark/quark-core - Pagination Utilities
  *
  * Provides offset-based pagination helpers that integrate with Prisma's
  * skip/take API and the project's ValidationError convention.
  *
  * Usage in a route handler:
  *
- *   import { parsePaginationQuery } from "@techstream/quark-core";
+ *   import { parsePaginationQuery } from "@usequark/quark-core";
  *
  *   export async function GET(request) {
  *     const { searchParams } = new URL(request.url);

package/src/query-builder.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Query Builder
+ * @usequark/quark-core - Query Builder
  * Builds Prisma where/orderBy clauses from query parameters
  * with validation and sanitization.
  */

package/src/queue/index.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Job Queue Module
+ * @usequark/quark-core - Job Queue Module
  * Provides BullMQ queue initialization and management
  */
 

package/src/rate-limiter.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Rate Limiting Module
+ * @usequark/quark-core - Rate Limiting Module
  * Provides both in-memory and Redis-based rate limiting
  */
 

package/src/request-logger.js

@@ -70,7 +70,7 @@ function sanitizeObject(obj, fields = SENSITIVE_FIELDS) {
  * @returns {Function} Middleware function
  *
  * @example
- * import { createRequestLogger } from "@techstream/quark-core";
+ * import { createRequestLogger } from "@usequark/quark-core";
  *
  * const logRequest = createRequestLogger({
  *   logRequestBody: true,

package/src/sms.js

@@ -1,12 +1,12 @@
 /**
- * @techstream/quark-core - SMS Service
+ * @usequark/quark-core - SMS Service
  *
  * Providers are defined using a Strategy Pattern - each implements the same
  * interface. Quark ships with one built-in provider (twilio) and exposes a
  * registry so users can plug in any provider they need.
  *
  * @example Custom provider
- *   import { SmsProvider, registerSmsProvider } from "@techstream/quark-core";
+ *   import { SmsProvider, registerSmsProvider } from "@usequark/quark-core";
  *
  *   class AmazonSnsProvider extends SmsProvider {
  *     async sendSms(to, body) { ... }

package/src/storage-s3.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - S3 Storage Adapter
+ * @usequark/quark-core - S3 Storage Adapter
  *
  * Kept in its own module so `storage.js` (and the main barrel) never pull
  * the AWS SDK onto the import path: `@aws-sdk/client-s3` and
@@ -32,7 +32,7 @@ async function importS3ClientPackage() {
 	} catch (error) {
 		if (isMissingPackageError(error, S3_CLIENT_PACKAGE)) {
 			throw new Error(
-				'S3 storage support requires installing "@aws-sdk/client-s3" in the app that uses @techstream/quark-core/storage/s3.',
+				'S3 storage support requires installing "@aws-sdk/client-s3" in the app that uses @usequark/quark-core/storage/s3.',
 			);
 		}
 		throw error;
@@ -47,7 +47,7 @@ async function importS3PresignerPackage() {
 	} catch (error) {
 		if (isMissingPackageError(error, S3_PRESIGNER_PACKAGE)) {
 			throw new Error(
-				'Signed upload URLs require installing "@aws-sdk/s3-request-presigner" in the app that uses @techstream/quark-core/storage/s3.',
+				'Signed upload URLs require installing "@aws-sdk/s3-request-presigner" in the app that uses @usequark/quark-core/storage/s3.',
 			);
 		}
 		throw error;

package/src/storage.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - File Storage
+ * @usequark/quark-core - File Storage
  *
  * Adapter-based storage abstraction supporting local filesystem and
  * S3-compatible providers (AWS S3, Cloudflare R2, MinIO, etc.).
@@ -23,7 +23,7 @@ import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { pipeline } from "node:stream/promises";
 
 // Import + re-export the S3 adapter so existing deep-imports continue
-// to work (`import { createS3Storage } from "@techstream/quark-core/storage"`).
+// to work (`import { createS3Storage } from "@usequark/quark-core/storage"`).
 // storage-s3.js has no top-level AWS SDK imports, so this stays safe for
 // local-only deployments that never installed the optional peer deps.
 import { createS3Storage } from "./storage-s3.js";

package/src/stripe.js

@@ -1,12 +1,12 @@
 /**
- * @techstream/quark-core - Stripe Integration
+ * @usequark/quark-core - Stripe Integration
  *
  * Thin wrappers around the Stripe SDK for client creation and webhook
  * verification. Stripe is an optional peer dependency — install it in the
  * app that uses payment features.
  *
  * Usage:
- *   import { createStripeClient, getStripeWebhookEvent } from "@techstream/quark-core/stripe";
+ *   import { createStripeClient, getStripeWebhookEvent } from "@usequark/quark-core/stripe";
  *
  *   const stripe = await createStripeClient();
  *   const session = await stripe.checkout.sessions.create({ ... });
@@ -30,7 +30,7 @@ async function importStripePackage() {
 	} catch (error) {
 		if (isMissingPackageError(error, "stripe")) {
 			throw new Error(
-				'Stripe support requires installing "stripe" in the app that uses @techstream/quark-core/stripe.',
+				'Stripe support requires installing "stripe" in the app that uses @usequark/quark-core/stripe.',
 			);
 		}
 		throw error;

package/src/testing/factories.js

@@ -2,7 +2,7 @@
  * Test data factories for creating realistic test objects with sensible defaults.
  *
  * Usage:
- *   import { createTestUser, createTestSession } from "@techstream/quark-core/testing";
+ *   import { createTestUser, createTestSession } from "@usequark/quark-core/testing";
  *   const user = createTestUser({ name: "Custom Name" });
  *   const session = createTestSession({ user: { role: "admin" } });
  *

package/src/testing/index.js

@@ -1,7 +1,7 @@
 /**
  * Quark test utilities - zero-dependency helpers for testing Quark applications.
  *
- * Import from `@techstream/quark-core/testing` in your test files:
+ * Import from `@usequark/quark-core/testing` in your test files:
  *
  * ```js
  * import {
@@ -17,7 +17,7 @@
  *   createTestContext,
  *   assertThrows,
  *   assertApiResponse,
- * } from "@techstream/quark-core/testing";
+ * } from "@usequark/quark-core/testing";
  * ```
  *
  * @module testing

package/src/types.js

@@ -1,5 +1,5 @@
 /**
- * @techstream/quark-core - Type Definitions
+ * @usequark/quark-core - Type Definitions
  * TypeScript types and JSDoc type definitions for better IDE support
  */
 

package/src/utils.js

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 
 /**
- * @techstream/quark-core - Utility Functions
+ * @usequark/quark-core - Utility Functions
  * Common utility functions used across the platform
  */
 
@@ -111,7 +111,7 @@ export const isObject = (item) => {
 };
 
 /**
- * @deprecated Use `getErrorMessage` from `@techstream/quark-core/errors` instead.
+ * @deprecated Use `getErrorMessage` from `@usequark/quark-core/errors` instead.
  * Normalizes error messages for consistency
  * @param {Error|string} error - Error to normalize
  * @returns {string} Normalized error message