@jskit-ai/agent-docs 0.1.69 → 0.1.70

package/guide/agent/app-setup/database-layer.md

@@ -58,9 +58,10 @@ The app gets three database scripts in `package.json`:
 ```json
 {
   "scripts": {
-    "db:migrate": "knex --knexfile ./knexfile.js migrate:latest",
+    "db:migrations:sync": "jskit migrations changed",
+    "db:migrate": "npm run db:migrations:sync && knex --knexfile ./knexfile.js migrate:latest",
     "db:migrate:rollback": "knex --knexfile ./knexfile.js migrate:rollback",
-    "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
+    "db:migrate:status": "npm run db:migrations:sync && knex --knexfile ./knexfile.js migrate:list"
   }
 }
 ```
@@ -95,12 +96,14 @@ The app has two different migration-related layers:
 
 Those are **not** the same step.
 
+The npm scripts hide the easy-to-miss first step for normal use. `npm run db:migrate` and `npm run db:migrate:status` run `npm run db:migrations:sync` first, then run Knex. That means package upgrades can add new JSKIT-managed migration files before Knex checks what is pending.
+
 ### `jskit migrations ...` writes managed migration files
 
-If you run:
+If you run the sync script directly:
 
 ```bash
-npx jskit migrations changed
+npm run db:migrations:sync
 ```
 
 JSKIT checks the installed package state in `.jskit/lock.json` and materializes any managed migration files that need to exist in `migrations/`.
@@ -538,9 +541,10 @@ After installing the MySQL runtime, the important new pieces in `package.json` l
     "mysql2": "^3.11.2"
   },
   "scripts": {
-    "db:migrate": "knex --knexfile ./knexfile.js migrate:latest",
+    "db:migrations:sync": "jskit migrations changed",
+    "db:migrate": "npm run db:migrations:sync && knex --knexfile ./knexfile.js migrate:latest",
     "db:migrate:rollback": "knex --knexfile ./knexfile.js migrate:rollback",
-    "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
+    "db:migrate:status": "npm run db:migrations:sync && knex --knexfile ./knexfile.js migrate:list"
   }
 }
 ```
@@ -552,11 +556,12 @@ Those new dependencies divide into two roles:
 - `knex` is the database toolkit used by both runtime code and migration commands
 - `mysql2` is the actual Node driver that speaks to MySQL
 
-The three new scripts are also worth reading carefully:
+The migration scripts are also worth reading carefully:
 
-- `db:migrate` applies all pending migrations
+- `db:migrations:sync` writes or refreshes JSKIT-managed migration files in `migrations/`
+- `db:migrate` syncs JSKIT-managed migration files, then applies all pending Knex migrations
 - `db:migrate:rollback` rolls back the last migration batch
-- `db:migrate:status` lists applied and pending migrations
+- `db:migrate:status` syncs JSKIT-managed migration files, then lists applied and pending migrations
 
 They are not special JSKIT commands. They are ordinary project scripts, which makes them easy to run in any environment.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.69",
+  "version": "0.1.70",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

package/reference/autogen/packages/auth-provider-local-core.md

@@ -62,7 +62,7 @@ Local functions
 
 ### `src/server/lib/service.js`
 Exports
-- `createLocalAuthService({ backend, config, profileProjector = null, passwordStrategy = null })`
+- `createLocalAuthService({ backend, config, profileProjector = null, passwordStrategy = null, invitationContextResolver = null })`
 Local functions
 - `nowSeconds()`
 - `isoFromNow(seconds)`
@@ -75,11 +75,12 @@ Local functions
 - `clearCookieOptions(isProduction)`
 - `buildProfile(user)`
 - `buildActor(user, profile = null)`
-- `buildAuthPayload({ user, session, profileProjector })`
+- `buildAuthPayload({ user, session, profileProjector, profileOptions = {} })`
 - `buildAccessToken({ user, session, secret, ttlSeconds = ACCESS_TTL_SECONDS })`
 - `buildSessionPayload({ user, session, refreshToken, secret })`
 - `validatePasswordInput(password)`
 - `validateEmailInput(email)`
+- `normalizeInvitationInput(value = null)`
 - `maybeSendRecoveryEmail(config, recoveryUrl, email)`
 
 ### `src/server/lib/tokens.js`

package/reference/autogen/packages/auth-web.md

@@ -56,6 +56,9 @@ Exports
 ### `src/client/composables/loginView/useLoginViewState.js`
 Exports
 - `useLoginViewState({ placementContext } = {})`
+Local functions
+- `readWindowSearchParam(name = "")`
+- `resolveInitialMode()`
 
 ### `src/client/composables/loginView/useLoginViewValidation.js`
 Exports

package/reference/autogen/packages/users-core.md

@@ -293,6 +293,10 @@ Exports
 Exports
 - None
 
+### `templates/migrations/users_core_profile_updated_at.cjs`
+Exports
+- None
+
 ### `templates/migrations/users_core_profile_username.cjs`
 Exports
 - None

package/reference/autogen/packages/workspaces-core.md

@@ -207,11 +207,26 @@ Exports
 Local functions
 - `resolveWorkspaceAggregateRecordId(record = {}, context = {})`
 
+### `src/server/workspaceMembers/defaultWorkspaceInviteEmail.js`
+Exports
+- `renderDefaultWorkspaceInviteEmail({ inviteUrl = "", workspace = {}, inviter = null, roleSid = "member", expiresAt = "" } = {})`
+Local functions
+- `escapeHtml(value = "")`
+
 ### `src/server/workspaceMembers/registerWorkspaceMembers.js`
 Exports
 - `registerWorkspaceMembers(app)`
 Local functions
 - `resolveWorkspaceMembersInviteExpiresInMs(appConfig = {})`
+- `resolveWorkspaceInviteEmailTemplate(scope, appConfig = {})`
+
+### `src/server/workspaceMembers/workspaceInviteUrls.js`
+Exports
+- `buildInvitePath(token, pathTemplate = "/invite/:token")`
+- `createWorkspaceInviteUrlBuilder({ appConfig = {}, env = {} } = {})`
+Local functions
+- `normalizeInvitePathTemplate(value = "")`
+- `normalizeBaseUrl(value = "")`
 
 ### `src/server/workspaceMembers/workspaceMembersActions.js`
 Exports
@@ -219,13 +234,14 @@ Exports
 
 ### `src/server/workspaceMembers/workspaceMembersService.js`
 Exports
-- `createService({ workspaceMembershipsRepository, workspaceInvitesRepository, inviteExpiresInMs, roleCatalog = null, workspaceInvitationsEnabled = true } = {})`
+- `createService({ workspaceMembershipsRepository, workspaceInvitesRepository, inviteExpiresInMs, roleCatalog = null, workspaceInvitationsEnabled = true, inviteUrlBuilder = null, workspaceInviteMailer = null, workspaceInviteEmailTemplate = renderDefaultWorkspaceInviteEmail } = {})`
 
 ### `src/server/workspacePendingInvitations/bootWorkspacePendingInvitations.js`
 Exports
 - `bootWorkspacePendingInvitations(app)`
 Local functions
 - `resolveAuthenticatedUserRecordId(_record, context = {})`
+- `resolveInviteResolutionRecordId(record = {})`
 
 ### `src/server/workspacePendingInvitations/registerWorkspacePendingInvitations.js`
 Exports
@@ -287,6 +303,7 @@ Exports
 - `WORKSPACE_INVITES_TRANSPORT`
 - `WORKSPACE_INVITE_CREATE_TRANSPORT`
 - `WORKSPACE_INVITE_REDEEM_TRANSPORT`
+- `WORKSPACE_INVITATION_RESOLVE_TRANSPORT`
 - `WORKSPACE_PENDING_INVITATIONS_TRANSPORT`
 
 ### `src/shared/operationMessages.js`
@@ -427,6 +444,10 @@ Local functions
 - `hasColumn(knex, tableName, columnName)`
 - `normalizeHexColor(value)`
 
+### `templates/packages/main/src/server/email/workspaceInviteEmail.js`
+Exports
+- `renderWorkspaceInviteEmail({ inviteUrl = "", workspace = {}, inviter = null, roleSid = "member", expiresAt = "" } = {})`
+
 ### root
 
 ### `package.descriptor.mjs`

package/reference/autogen/packages/workspaces-web.md

@@ -39,6 +39,7 @@ Local functions
 - `isRevokeInviteLoading(inviteId)`
 - `isRemoveMemberLoading(memberUserId)`
 - `onSubmitInvite()`
+- `onCopyInviteLink()`
 - `onRevokeInvite(inviteId)`
 - `onMemberRoleUpdate(member, roleSid)`
 - `onRemoveMember(member)`
@@ -73,6 +74,14 @@ Exports
 Exports
 - None
 
+### `src/client/components/WorkspaceInviteLanding.vue`
+Exports
+- None
+Local functions
+- `buildAuthUrl(mode)`
+- `refreshInvite()`
+- `acceptInvite()`
+
 ### `src/client/components/WorkspaceMembersClientElement.vue`
 Exports
 - None
@@ -91,6 +100,7 @@ Local functions
 - `applyWorkspaceSettingsPolicy(payload = {})`
 - `refreshLoad()`
 - `submitInvite()`
+- `copyCreatedInviteLink()`
 - `submitRevokeInvite(inviteId)`
 - `submitMemberRoleUpdate(member, roleSid)`
 - `submitRemoveMember(member)`
@@ -125,6 +135,7 @@ Local functions
 Exports
 - `WorkspacesWebClientProvider`
 - `WorkspaceMembersClientElement`
+- `WorkspaceInviteLanding`
 - `clientProviders`
 
 ### `src/client/lib/bootstrap.js`
@@ -335,6 +346,10 @@ Exports
 Exports
 - None
 
+### `templates/src/pages/invite/[token].vue`
+Exports
+- None
+
 ### `templates/src/surfaces/admin/index.vue`
 Exports
 - None