@iztzelios/core 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+## 0.1.0
+
+First pre-release. The package stays on `0.x` until 1.0.0 is declared stable: each fix is a patch release (`0.1.1`, `0.1.2`, …); new features or breaking changes bump the minor (`0.2.0`).
+
+TypeScript rewrite of `izteach-core-alternative-model` 2.6.59 as `@iztzelios/core`.
+
+### Breaking (packaging / environment)
+- **Per-model imports.** The root entry no longer exports models. Use `@iztzelios/core/models/<name>`, `@iztzelios/core/dynamo/<name>`, `@iztzelios/core/services/<name>` (or the `@iztzelios/core/models` barrel). `scripts/migrate-imports.cjs` rewrites services automatically.
+- **Mongoose 9** is a peer dependency (was Mongoose 5 bundled). Services must use `mongoose@^9`. Node ≥ 20.19.
+- **AWS SDK v3** replaces `aws-sdk` v2 and is an optional peer, provided by the Lambda runtime. The package no longer installs `aws-sdk`, `googleapis`, `lodash`, `axios`, `request`, `moment`, `uuid` or `module-alias`. Services that relied on those transitively must declare them.
+- **No hardcoded credentials.** JWT secrets come from `IZTEACH_JWT_ACCESS_SECRET` / `IZTEACH_JWT_REFRESH_SECRET`, mail credentials from `IZTEACH_EMAIL_CREDENTIALS`. `MONGO` is required (the fallback URI is gone).
+- **Tenant-scoped reads and removes.** `remove({ id, vendorId })` replaces `remove(id)` and throws `AppError` (`1050`) without both, so a document can only be deleted within its vendor. `InterestModel.remove` and `KeywordHelper.onCourseCreate/onCourseUpdate` take `vendorId` too.
+- **Object-style reads.** `fetch({ criteria, populate, selects })`, `findOne({ criteria, populate, selects })`, `fetchOne({ id, vendorId, populate, selects })`, `fetchMany({ ids, vendorId, populate, selects })`; the id-based ones require `vendorId`. The positional forms keep working (`@deprecated`, not tenant-scoped) so services can switch imports first and call sites later.
+- **No hosting-provider integration.** `DomainModel` only manages records: `create` stores the domain (and still adds learn domains to `RootSystem_Vendor`), `remove({ id, vendorId })` is the generic delete. It no longer calls Netlify; `removeManyNetlify`, `activateSSL` and the `NETLIFY_SETTINGS` / `VERCEL_SETTINGS` constants are removed. The service that creates domains registers them with the hosting provider.
+- `AuthorModel.changePassword` is removed: passwords live on the Dynamo user (`UserModel.update`). The legacy method always threw.
+- **Timestamps come from Mongoose.** Every schema sets `timestamps: true` (MistakeBank keeps `updatedAt: 'lastUpdatedAt'`); the hand-declared `createdAt`/`updatedAt` fields and the misspelled `createAt`/`updateAt` fields are removed, and `create`/`createMany`/`update`/`updateMany`/`updateOrCreate` no longer stamp by hand. Effects:
+  - Collections whose schema lacked one or both fields (e.g. Activity, Log, Progress, Streak, Order, Cart, Coupon, Book, Submission) now store them.
+  - `create` keeps a caller-supplied `createdAt` (legacy overwrote it with now). `createdAt` cannot be changed by an update.
+  - Writes through `getModel()` (`updateOne`, `bulkWrite`, …) also bump `updatedAt`.
+  - `MongoCoreModel` only stamps if the model passed in has `timestamps`.
+  - Values written to the old `createAt`/`updateAt` fields are dropped (strict schemas); existing data in them is still returned on reads. Indexes on these fields are kept (`Schema.index`), except Survey_Result `createdAt` / `updateAt`: those indexes are managed outside this library.
+- `NotifyHelper` returns `{ status, data }` from `fetch` instead of an axios response.
+
+### Behaviour kept on purpose
+- `undefined` values in update payloads (`update`, `updateMany`, `updateOrCreate`, `findOneAndUpdate`, `create` with `dynamoId`) are still written as `null`, as Mongoose 5 did (Mongoose 7+ drops them). E.g. `UserCourse/UserBook/UserMembership.createMany` without `group` still pushes `null` into `groups`. `bulkWrite` is passed through unchanged.
+- `update()` upserts, `removeMany()` needs `vendorId`, 24-char id ⇄ `dynamoId` handling, default sort `updatedAt: -1`, plain-object results with `id`.
+- Token format is byte-compatible: tokens signed by 2.x verify with this package and vice versa (checked against the published 2.5.13 helper).
+- `removeUnicode` output is identical to the unidecode-based version for every script (tested over the whole BMP against `unidecode` 0.1.8), so existing `tags` keep matching. The unidecode tables are vendored (`src/common/unidecode-data.ts`, ~95 KB) instead of being a runtime dependency.
+- Password cipher and Base64 handling are identical (the legacy Base64 plugin is ported as is, including how it decodes `btoa()` Latin-1 input and unpadded strings; tested), so existing passwords keep working.
+
+### Fixes
+- `fetch`/`count` query shortcuts match suffixes only: a field named `user_info` is no longer turned into `user: { $in }`.
+- `findOne` no longer populates twice; `fetchOne` passes `selects` through.
+- The generic `sum()` (it called a nonexistent `Model.sum`) is removed. Bill / AnonymousBill / Order / BillStatistic keep their own `sum`.
+- `connect()` caches the pending promise: concurrent cold-start calls share one connection.
+- `TokenHelper.verify` returns real `iat`/`exp` in ms (legacy returned `NaN`). `TokenHelper` works again: legacy 2.6.x shipped an empty `plugins/jsonwebtoken.js`.
+- `AuthorModel.remove` archives the author by id within its vendor and never upserts (returns `null` if the author is gone). Legacy passed a string to `update`, which upserted a stray document.
+- `StudentModel.update` with a `name` rejects with an `AppError` when the student does not exist (legacy crashed with a `TypeError`); updates without a `name` no longer look the student up.
+- `StudentModel.changePassword` no longer throws `ReferenceError: item is not defined`.
+- `KeywordHelper.onTopicRemove` removes the topic (legacy looked up the index in `authors`); author/topic updates no longer touch the wrong element when not found.
+- Dynamo `fetch`/`fetchByIndex`: `_start`, `_sort`, `roles_contain` no longer leak into the key condition; `roles_contain` without other filters produces a valid `FilterExpression`.
+- `utility.toArray` returns the array (legacy returned `undefined`).
+- `UserMembership/UserBook/UserCourse.createMany`, `findOneAndUpdate`: legacy `new: true` is translated to `returnDocument: 'after'`.
+- Duplicate keys in a few schemas (exam `sortQuestion`, flashcard-submission `state`, online-course `updatedAt`, resource `tags`, user-book / user-course `user`) are deduplicated, keeping the effective (last) definition.

package/README.md

@@ -1,3 +1,173 @@
-# Temporary Holding Version
+# @iztzelios/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared data-access library for IZTeach Lambda services: Mongo models (Mongoose 9), Dynamo models (AWS SDK v3), and shared helpers (email, push, token, errors).
+
+TypeScript rewrite of `izteach-core-alternative-model` / `izteach-core-model`. It keeps the same model method names and behaviour, but each model has **its own import path**, so a Lambda only loads (and, when bundled, only ships) the models it uses.
+
+## Install
+
+```bash
+npm i @iztzelios/core mongoose@^9
+```
+
+| Dependency | When you need it |
+|---|---|
+| `mongoose` ^9 (peer) | always |
+| `@aws-sdk/client-dynamodb`, `@aws-sdk/lib-dynamodb` | `@iztzelios/core/dynamo/*`, `services/user`, `services/email-ses`, Student/Author models. **Already in the Lambda Node.js runtime**, so add them as devDependencies only (types and local runs). |
+| `@aws-sdk/client-ses`, `client-s3`, `client-sts` | `services/email-ses` (also runtime-provided; devDependency) |
+| `google-auth-library` | `services/notify`, `models/notify` (push notifications) |
+| `jsonwebtoken` | `services/token` |
+
+Node ≥ 20.19 (Mongoose 9 requirement).
+
+## Usage
+
+```js
+const { MongoDB, AppError } = require('@iztzelios/core')
+const { ResourceModel } = require('@iztzelios/core/models/resource')
+const { UserModel } = require('@iztzelios/core/dynamo/user')
+const { EmailSESHelper } = require('@iztzelios/core/services/email-ses')
+
+exports.lambdaHandler = async event => {
+  await MongoDB.init() // or: await connect(). Reads process.env.MONGO; one connection per container.
+  return ResourceModel.fetch({
+    criteria: { vendorId: event.vendorId, type_in: ['video'], _sort: 'createdAt:-1', _limit: 20 },
+    selects: 'title type url',
+  })
+}
+```
+
+ESM works too: `import { ResourceModel } from '@iztzelios/core/models/resource'`.
+
+### Entry points
+
+| Import path | Contents |
+|---|---|
+| `@iztzelios/core` | `MongoDB` / `connect`, `createMongoModel` (`genrerateModel`), `MongoCoreModel`, `AppError`, `ErrorCode`, `ErrorHelper`, `Constant` and the other constants, utilities (`removeUnicode`, `cleanObject`, `cipher`, …). **No models.** |
+| `@iztzelios/core/models/<name>` | One Mongo model, e.g. `models/resource` → `ResourceModel`, `models/online-course` → `OnlineCourseModel`. Folder names match the legacy `model/<name>`. |
+| `@iztzelios/core/models` | Barrel of every Mongo model. Handy while migrating, but it loads everything. |
+| `@iztzelios/core/dynamo/<name>` | `user`, `vendor`, `vendor-settings`, `vendor-credential`, `token`; `dynamo/core` → `DynamoCoreModel` |
+| `@iztzelios/core/services/<name>` | `email-ses` (`EmailSESHelper`), `notify` (`NotifyHelper`), `token` (`TokenHelper`), `user` (`UserHelper`), `keyword` (`KeywordHelper`), `submission` (`SubmissionHelper`), `combo`, `affiliate` |
+
+### Model API
+
+Same method names as the legacy package. Reads take one query object; every id-based call is scoped to a tenant:
+
+```js
+XModel.fetch({ criteria: { vendorId, _limit: 10 }, populate: 'author', selects: 'title author' })
+XModel.findOne({ criteria: { vendorId, code }, selects: 'title' })
+XModel.fetchOne({ id, vendorId, populate: 'author' }) // throws AppError without id + vendorId
+XModel.fetchMany({ ids, vendorId })                    // throws AppError without ids + vendorId
+XModel.remove({ id, vendorId })                        // throws AppError without id + vendorId
+```
+
+The legacy positional reads (`fetch(criteria, populate, selects)`, `fetchOne(id, populate, selects)`, `fetchMany(ids, populate)`, `findOne(criteria, populate)`) still work but are deprecated and not tenant-scoped. `remove(id)` is no longer accepted.
+
+Also: `create`, `createMany`, `update` (**upserts**), `updateMany`, `updateOrCreate`, `findOneAndUpdate`, `count`, `removeMany` (no-op without `vendorId`), `aggregate`, `bulkWrite`, `first`, `last`, `init`, plus `getModel()` for the raw Mongoose model.
+
+`fetch` / `count` query shortcuts: `field_in`, `field_nin`, `field_null`, `field_contain`, `_limit`, `_skip`, `_sort: 'a:1,b:-1'`, `_populate: 'a:b'`.
+
+Each model also exports its document type, e.g. `ResourceDoc`.
+
+## Environment variables
+
+| Variable | Used by |
+|---|---|
+| `MONGO` | MongoDB connection string (required) |
+| `ENV` | `prod` → production Dynamo tables; anything else → test tables |
+| `IZTEACH_JWT_ACCESS_SECRET`, `IZTEACH_JWT_REFRESH_SECRET` | `services/token`. Use the existing values so tokens already issued stay valid. |
+| `IZTEACH_EMAIL_CREDENTIALS` (JSON) | `Constant.EMAIL_CREDENTIALS` |
+| `IZTEACH_EMAIL_TEMPLATE_BUCKET` | optional; default `izteach-template-email-bucket2` |
+
+## Migrating a service
+
+1. Rewrite imports with
+   `node <this-repo>/scripts/migrate-imports.cjs <service>/src` (run `npm run build` in this repo first; add `--dry-run` to preview).
+   The script also lists packages the service `require`s without declaring them. The legacy package installed `aws-sdk` v2, `lodash`, `axios`, `moment`, … transitively, and they disappear with it.
+2. In the service's `package.json`: remove `izteach-core-model` / `izteach-core-alternative-model`, add `@iztzelios/core` and `mongoose@^9`, and declare whatever step 1 reported. Better still, move the service's own `aws-sdk` v2 code to `@aws-sdk/*` v3: v2 is ~80–100 MB, end-of-support, and not included in the Node 20+ runtime.
+3. Set the env vars above that the service needs (`IZTEACH_JWT_*` for token users).
+4. Optional, for the smallest artifacts: let SAM bundle the function with esbuild.
+
+```yaml
+  MyFunction:
+    Type: AWS::Serverless::Function
+    Properties:
+      CodeUri: src/
+      Handler: handler.lambdaHandler
+      Runtime: nodejs22.x
+    Metadata:
+      BuildMethod: esbuild
+      BuildProperties:
+        Target: es2022
+        Minify: true
+        EntryPoints: [handler.js]
+        External:
+          - '@aws-sdk/*'
+          - kerberos
+          - snappy
+          - '@mongodb-js/zstd'
+          - mongodb-client-encryption
+          - aws4
+          - gcp-metadata
+          - socks
+```
+
+esbuild can't resolve `module-alias` (`@/…`) paths, so convert those to relative paths first. If the function imports `models/notify`, `services/notify` or the `models` barrel, install `google-auth-library` or add it to `External`.
+
+Measured on `izteach-resource-service`: production `node_modules` went from 267 MB (legacy, including `googleapis` and `aws-sdk` pulled in by the old package) to 135 MB. 100 MB of the remainder is the service's own `aws-sdk` v2 usage, leaving ~35 MB once it moves to v3. An esbuild bundle of a handler that uses only `ResourceModel` is 1.35 MB, of which 19 KB is this package.
+
+## Development
+
+```bash
+nvm use            # Node 22
+npm ci
+npm run typecheck
+npm test           # vitest; Mongo tests use mongodb-memory-server
+npm run build      # tsup (ESM .mjs + CJS .js) + tsc declarations
+npm run size-check # bundles a resource-only handler and asserts nothing else is included
+```
+
+### AWS SDK: never a runtime dependency
+
+The `@aws-sdk/*` v3 packages ship with the Lambda Node.js runtime, so this package must not install or bundle its own copy.
+
+- Keep them as **optional `peerDependencies`** plus `devDependencies` (for types and tests). Never move them to `dependencies`: every service would then install a second, pinned SDK. `test/exports.test.ts` fails if one is added.
+- Import them only in the modules that call AWS (`src/dynamo/*`, `src/core/dynamo-model.ts`, `src/db/dynamo.ts`, `src/services/email-ses*.ts`), never from the root entry (`src/index.ts`) or `src/common/*`. A root import would load SDK clients at cold start in every Lambda. `npm run size-check` cannot catch this (the SDK is external in that bundle), so check it in review.
+- The same applies to `google-auth-library` and `jsonwebtoken`: optional peers, imported only by `services/notify` and `services/token`.
+
+## Publishing (manual)
+
+Releases are published by hand for now. The GitHub workflows in `.github/workflows/` are commented out (see the bottom of this section).
+
+**Prerequisites**
+- Your npm account is an owner/member with publish rights in the [`@iztzelios`](https://www.npmjs.com/org/iztzelios) org (public packages only).
+- Node 22 (`nvm use`) and a clean checkout of `main` with dependencies installed (`npm ci`).
+
+**Steps**
+
+1. Pick the version. The package is pre-1.0 (`0.x`) until the API is declared stable:
+   - each fix → patch (`0.1.0` → `0.1.1`);
+   - new models/methods or breaking changes → minor (`0.1.x` → `0.2.0`). Services on `^0.1.0` only pick up `0.1.x` patches automatically, so a breaking change never reaches them unasked.
+   - `1.0.0` is released deliberately once the API is stable; from then on, normal semver (breaking → major).
+   ```bash
+   npm version <patch|minor|major> --no-git-tag-version   # updates package.json + package-lock.json
+   ```
+2. Add an entry for that version to `CHANGELOG.md`, including any behaviour change consumers must know about.
+3. Verify locally:
+   ```bash
+   npm run typecheck && npm test && npm run size-check
+   npm pack --dry-run     # lists exactly what will be uploaded: dist/, README.md, CHANGELOG.md, package.json
+   npm pkg get dependencies   # must print {}: no @aws-sdk/* (see "AWS SDK: never a runtime dependency")
+   ```
+4. Publish:
+   ```bash
+   npm login                     # once per machine
+   npm publish --access public   # prepublishOnly runs typecheck + build again
+   ```
+5. Check it's live: `npm view @iztzelios/core version`.
+6. Commit the version bump and changelog (`chore: release vX.Y.Z`), tag it (`git tag vX.Y.Z`), and push both.
+7. Consumer services pick it up by bumping `@iztzelios/core` in their `package.json` and redeploying (`sam build && sam deploy`).
+
+A published version can't be overwritten. If something is wrong, publish a new patch version. Use `npm deprecate @iztzelios/core@X.Y.Z "<reason>"` to warn users of a bad one. `npm unpublish` only works within 72 hours and is discouraged.
+
+**Re-enabling automation later.** Uncomment `.github/workflows/ci.yml` and `publish.yml`. Then, on npmjs.com, open `@iztzelios/core` → Settings → Trusted Publisher and add GitHub Actions with repo `izteach/izteach-core-service` and workflow `publish.yml`. After that, merging a version bump to `main` publishes automatically.

package/dist/chunk-22TJJOSX.mjs

@@ -0,0 +1,40 @@
+import { createMongoModel } from './chunk-MAWBRJ77.mjs';
+import { Schema } from 'mongoose';
+
+var LOG_COLLECTION = `System_Log`;
+var LogSchema = new Schema(
+  {
+    vendorId: { required: true, type: String },
+    actionBy: { id: { required: true, type: String }, email: { required: true, type: String }, name: String },
+    action: {
+      required: true,
+      type: String,
+      enum: ["create", "update", "delete", "assign"],
+      default: "create"
+    },
+    // { id: String, title: String, type: { type: String, enum: ['permission', 'course'] }, data: Schema.Types.Mixed }
+    actionTarget: Schema.Types.Mixed,
+    actionSource: {
+      id: String,
+      title: String,
+      type: {
+        type: String,
+        enum: ["default", "group", "payment", "membership", "free", "active-code", "unit"],
+        default: "default"
+      },
+      data: Schema.Types.Mixed
+    },
+    // { id: String, email: String, role: String }
+    affectTo: Schema.Types.Mixed,
+    time: { required: true, type: Number },
+    metadata: Schema.Types.Mixed
+  },
+  { collection: LOG_COLLECTION, bufferCommands: false, timestamps: true }
+);
+LogSchema.set("toObject", { virtuals: true });
+var definition = { Schema: LogSchema, Name: LOG_COLLECTION };
+
+// src/models/log/index.ts
+var LogModel = createMongoModel(definition);
+
+export { LogModel };

package/dist/chunk-264PR62T.js

@@ -0,0 +1,39 @@
+'use strict';
+
+var chunkGYJFNTLM_js = require('./chunk-GYJFNTLM.js');
+var mongoose = require('mongoose');
+
+var COLLECTION = `Payment_Affiliate`;
+var AffiliateSchema = new mongoose.Schema(
+  {
+    vendorId: {
+      type: String,
+      required: true
+    },
+    kolId: {
+      type: String,
+      required: true
+    },
+    kolInfo: mongoose.Schema.Types.Mixed,
+    settings: {
+      generalSettings: mongoose.Schema.Types.Mixed,
+      detailSettings: Array,
+      isUseGeneralSettings: {
+        type: Boolean,
+        default: true
+      }
+    }
+  },
+  {
+    collection: COLLECTION,
+    bufferCommands: false,
+    timestamps: true
+  }
+);
+AffiliateSchema.set("toObject", { virtuals: true });
+var definition = { Schema: AffiliateSchema, Name: COLLECTION };
+
+// src/models/affiliate/index.ts
+var AffiliateModel = chunkGYJFNTLM_js.createMongoModel(definition);
+
+exports.AffiliateModel = AffiliateModel;

package/dist/chunk-2M2D6KBL.mjs

@@ -0,0 +1,83 @@
+import { validate } from './chunk-KN2GXKK3.mjs';
+import { USER_PROFILE_TABLE } from './chunk-NMOY5GCF.mjs';
+import { getDocumentClient, generateExpressionAttributeValues, generateExpressionAttributeNames, update, fetchMany, removeMany, remove, count, fetch, findOne, fetchOne, create } from './chunk-PZ74YMNX.mjs';
+import { cleanObject, cipher, Base64 } from './chunk-MJTDRI7E.mjs';
+import { randomUUID } from 'crypto';
+import { QueryCommand } from '@aws-sdk/lib-dynamodb';
+
+var UserModel = {
+  TABLE: USER_PROFILE_TABLE,
+  async create(item) {
+    await validate(item);
+    return create(USER_PROFILE_TABLE, {
+      ...item,
+      sortKeyCreate: `user-profile_${Date.now()}`,
+      sortKeyUpdate: `user-profile_${Date.now()}`,
+      state: item.state || "unverified",
+      updatedAt: Date.now(),
+      createdAt: Date.now(),
+      dataType: "user-profile",
+      id: randomUUID(),
+      password: cipher(item.vendorId)(Base64.decode(item.password))
+    });
+  },
+  fetchOne: (criteria) => fetchOne(USER_PROFILE_TABLE, criteria),
+  findOne: (criteria, index) => findOne(USER_PROFILE_TABLE, criteria, index),
+  fetch: (criteria) => fetch(USER_PROFILE_TABLE, criteria),
+  count: (criteria, index) => count(USER_PROFILE_TABLE, criteria, index),
+  remove: (criteria) => remove(USER_PROFILE_TABLE, criteria),
+  removeMany: (criteria = {}) => removeMany(USER_PROFILE_TABLE, criteria),
+  fetchMany: (criterias = []) => fetchMany(USER_PROFILE_TABLE, criterias),
+  update(query, item) {
+    if (item.password) item.password = cipher(query.vendorId)(Base64.decode(item.password));
+    return update(USER_PROFILE_TABLE, query, item);
+  },
+  /** Every user of a vendor with `role` in `roles` (follows pagination). */
+  async fetchClients(criteria) {
+    let items = [];
+    let lastEvaluatedKey;
+    do {
+      const data = await getDocumentClient().send(
+        new QueryCommand({
+          TableName: USER_PROFILE_TABLE.TABLE_NAME,
+          KeyConditionExpression: "#vendorId = :vendorId",
+          FilterExpression: "#dataType = :dataType and contains(#roles, :role)",
+          ExpressionAttributeValues: {
+            ":vendorId": criteria.vendorId,
+            ":role": criteria.role,
+            ":dataType": criteria.dataType
+          },
+          ExpressionAttributeNames: { "#vendorId": "vendorId", "#roles": "roles", "#dataType": "dataType" },
+          ExclusiveStartKey: lastEvaluatedKey
+        })
+      );
+      items = items.concat(data.Items ?? []);
+      lastEvaluatedKey = data.LastEvaluatedKey;
+    } while (lastEvaluatedKey);
+    return { Items: items };
+  },
+  /** Count of users with `roles` containing criteria.roles and `state`, created in [createdAt_gt, createdAt_lt]. */
+  async countByTimeRage(criteria, index) {
+    const data = await getDocumentClient().send(
+      new QueryCommand(
+        cleanObject({
+          TableName: USER_PROFILE_TABLE.TABLE_NAME,
+          IndexName: index,
+          KeyConditionExpression: "#vendorId = :vendorId AND #createdAt BETWEEN :createdAt_gt AND :createdAt_lt",
+          ExpressionAttributeNames: generateExpressionAttributeNames({
+            roles: criteria.roles,
+            vendorId: criteria.vendorId,
+            createdAt: criteria.createdAt_lt,
+            state: criteria.state
+          }),
+          ExpressionAttributeValues: generateExpressionAttributeValues(criteria),
+          FilterExpression: "contains (#roles, :roles) AND #state = :state",
+          Select: "COUNT"
+        })
+      )
+    );
+    return { count: data.Count || 0, time: new Date(criteria.createdAt_gt).toISOString() };
+  }
+};
+
+export { UserModel };

package/dist/chunk-2PKDFJLS.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var chunkGYJFNTLM_js = require('./chunk-GYJFNTLM.js');
+var mongoose = require('mongoose');
+
+var COLLECTION = `Utility_ResourceStatistic`;
+var ResourceStatisticSchema = new mongoose.Schema(
+  {
+    vendorId: {
+      type: String,
+      required: true
+    },
+    month: {
+      type: Number,
+      required: true
+    },
+    year: {
+      type: Number,
+      required: true
+    },
+    type: {
+      type: String,
+      required: true
+    },
+    loadTimes: {
+      type: Number,
+      default: 0
+    },
+    bandwidth: {
+      type: Number,
+      default: 0
+    }
+  },
+  {
+    collection: COLLECTION,
+    strict: false,
+    bufferCommands: false,
+    timestamps: true
+  }
+);
+ResourceStatisticSchema.set("toObject", { virtuals: true });
+var definition = { Schema: ResourceStatisticSchema, Name: COLLECTION };
+
+// src/models/resource-statistic/index.ts
+var ResourceStatisticModel = chunkGYJFNTLM_js.createMongoModel(definition);
+
+exports.ResourceStatisticModel = ResourceStatisticModel;

package/dist/chunk-2QI362RF.mjs

@@ -0,0 +1,75 @@
+// src/common/error.ts
+var ErrorCode = {
+  // something went wrong
+  SOMETHING_WENT_WRONG: "-0001",
+  // custom
+  CUSTOM_TEMPLATE_MESSAGE: "0000",
+  // handler
+  HANDLER_UNSUPPORTED_DATA_TYPE: "0001",
+  HANDLER_UNSUPPORTED_COMMAND: "0002",
+  // Model
+  MODEL_CONSTRUCTOR_REQUIRE_CONFIG: "1001",
+  MODEL_CONSTRUCTOR_REQUIRE_TABLE_NAME: "1002",
+  MODEL_CONSTRUCTOR_REQUIRE_DATA_TYPE: "1003",
+  MODEL_FIND_ERROR: "1004",
+  MODEL_BATCH_FIND_ERROR: "1005",
+  MODEL_QUERY_ERROR: "1006",
+  MODEL_COUNT_ERROR: "1007",
+  MODEL_CREATE_ITEM_ID_ALREADY_EXISTS: "1008",
+  MODEL_CREATE_ERROR: "1009",
+  MODEL_UPDATE_ITEM_ID_NOT_EXISTS: "1010",
+  MODEL_UPDATE_ERROR: "1011",
+  MODEL_DELETE_ITEM_ID_NOT_EXISTS: "1012",
+  MODEL_DELETE_ITEM_IN_RELATION: "1013",
+  MODEL_DELETE_ERROR: "1014",
+  MODEL_BATCH_DELETE_ERROR: "1015",
+  // models
+  MODEL_FIELD_REQUIRED: "1050",
+  MODEL_FIELD_EXISTED: "1051",
+  MODEL_FIELD_INVALID: "1052",
+  MODEL_NOT_FOUND_ITEM_WITH_FIELD: "1053",
+  MODEL_ACTION_UNSUPPORTED_DATA_TYPE: "1054",
+  MODEL_ACTION_SUPPORT_FROM: "1055",
+  MODEL_ACTION_SUPPORT_TO: "1056",
+  MODEL_ACTION_ERROR: "1057",
+  MODEL_NOT_MATCH_FIELD: "1058",
+  MODEL_BILL_NOT_CLOSED: "1059",
+  MODEL_NOT_FOUND_RELATION_ID: "1060",
+  MODEL_ACTION_UNSUPPORTED_QUESTION_TYPE: "1061",
+  MODEL_BILL_ALREADY_BUY_COURSE: "1062",
+  MODEL_BILL_COURSE_IN_BILL_PENDING: "1063",
+  // auth 20xx
+  AUTH_UNAUTHORIZED: "2001",
+  AUTH_CAN_NOT_DO_ACTION_WITH_STATE: "2002",
+  AUTH_INVALID_PAYLOAD_STRING: "2003",
+  AUTH_VENDOR_ID_AND_CLIENT_ID_REQUIRED: "2004",
+  AUTH_PASWORD_NOT_MATCH: "2005",
+  AUTH_EMAIL_EXISTED: "2006",
+  AUTH_PHONE_EXISTED: "2007",
+  AUTH_PASWORD_PHONE_EMAIL_REQUIRED: "2008",
+  AUTH_PASWORD_USER_NOT_EXIST: "2009",
+  AUTH_PASWORD_USER_DISABLED: "2010",
+  AUTH_PASWORD_USER_NOT_VERIFIED: "2011",
+  AUTH_MISSING_STUDENT_ID: "2012"
+};
+var AppError = class extends Error {
+  code;
+  sourceError;
+  data;
+  customMessageTemplate;
+  constructor(option, ...params) {
+    super(params.map(String).join(","));
+    this.name = "AppError";
+    if (option instanceof Object) {
+      this.code = option.code ?? option.c;
+      this.sourceError = option.sourceError ?? option.se;
+      this.data = option.data ?? option.d;
+      this.customMessageTemplate = option.customMessageTemplate ?? option.cmt;
+    } else {
+      this.code = option;
+    }
+  }
+};
+var ErrorHelper = { ErrorCode, AppError };
+
+export { AppError, ErrorCode, ErrorHelper };

package/dist/chunk-2UIO464B.mjs

@@ -0,0 +1,32 @@
+import { createMongoModel } from './chunk-MAWBRJ77.mjs';
+import { Schema } from 'mongoose';
+
+var COLLECTION = `UserInteraction_MistakeStatistic`;
+var MistakeStatisticSchema = new Schema(
+  {
+    userId: { type: String, required: true },
+    vendorId: { type: String, required: true },
+    examType: { type: String, required: true },
+    // 'thpt' | 'hsa' | 'vact'
+    learningSubject: { type: String, required: true },
+    topicName: { type: String, default: "" },
+    wrongCount: { type: Number, default: 0 }
+  },
+  {
+    collection: COLLECTION,
+    bufferCommands: false,
+    timestamps: true
+  }
+);
+MistakeStatisticSchema.set("toObject", { virtuals: true });
+MistakeStatisticSchema.index(
+  { userId: 1, vendorId: 1, examType: 1, learningSubject: 1, topicName: 1 },
+  { unique: true }
+);
+MistakeStatisticSchema.index({ userId: 1, vendorId: 1, examType: 1, wrongCount: -1 });
+var definition = { Schema: MistakeStatisticSchema, Name: COLLECTION };
+
+// src/models/mistake-statistic/index.ts
+var MistakeStatisticModel = createMongoModel(definition);
+
+export { MistakeStatisticModel };

package/dist/chunk-2V4SNATM.js

@@ -0,0 +1,80 @@
+'use strict';
+
+var chunkQVHRKBUX_js = require('./chunk-QVHRKBUX.js');
+var chunkYZCTNLIJ_js = require('./chunk-YZCTNLIJ.js');
+var chunkGYJFNTLM_js = require('./chunk-GYJFNTLM.js');
+var chunkEOPDO4N4_js = require('./chunk-EOPDO4N4.js');
+var mongoose = require('mongoose');
+
+var COLLECTION = `OnlineLearning_Author`;
+var AuthorSchema = new mongoose.Schema(
+  {
+    vendorId: {
+      type: String,
+      required: true
+    },
+    avatar: mongoose.Schema.Types.Mixed,
+    description: String,
+    phone: String,
+    email: {
+      type: String,
+      required: true
+    },
+    fullname: String,
+    name: String,
+    userId: String,
+    profileId: String,
+    tags: String,
+    dataType: String,
+    createdBy: String,
+    migrate: mongoose.Schema.Types.Mixed,
+    metadata: mongoose.Schema.Types.Mixed,
+    data: mongoose.Schema.Types.Mixed,
+    isArchived: Boolean
+  },
+  {
+    collection: COLLECTION,
+    bufferCommands: false,
+    timestamps: true
+  }
+);
+AuthorSchema.set("toObject", { virtuals: true });
+var definition = { Schema: AuthorSchema, Name: COLLECTION };
+
+// src/models/author/index.ts
+var methods = chunkGYJFNTLM_js.createMongoModel(definition);
+var AuthorModel = {
+  ...methods,
+  /** Creates the Dynamo login (verified teacher) and the author profile. */
+  async create(input) {
+    const item = chunkQVHRKBUX_js.trim(input);
+    const user = await chunkYZCTNLIJ_js.UserModel.create({ ...item, state: "verified", type: "teacher", roles: ["teacher"] });
+    delete item.password;
+    return methods.create({
+      ...item,
+      profileId: user.id,
+      fullname: item.fullname || item.name,
+      tags: chunkEOPDO4N4_js.removeUnicode(item.name + " || " + item.email)
+    });
+  },
+  /** Deletes the Dynamo login and archives (does not delete) the author. Returns null if the author is gone. */
+  async remove(author) {
+    await chunkYZCTNLIJ_js.UserModel.remove({ id: author.profileId, vendorId: author.vendorId });
+    const archived = await methods.findOneAndUpdate(
+      { _id: author.id, vendorId: author.vendorId },
+      { isArchived: true },
+      { upsert: false }
+    );
+    return archived ? archived.toObject() : null;
+  },
+  async removeMany(criteria) {
+    await chunkYZCTNLIJ_js.UserModel.removeMany(criteria);
+    return methods.removeMany(criteria);
+  },
+  async update(criteria, item) {
+    if (item.password) delete item.password;
+    return methods.update(criteria, item);
+  }
+};
+
+exports.AuthorModel = AuthorModel;