@kelpie/server 0.1.0

package/dist/modules/hiring/schema.d.ts

@@ -0,0 +1,308 @@
+/**
+ * The value sets come from `@kelpie/schemas`, so these check constraints, the
+ * routes' Zod enums, and the browser's dropdowns are one list rather than three
+ * copies. Re-exported because `service.ts` and `routes.ts` read them from here,
+ * and the tables they constrain are the reason they matter.
+ */
+export { CANDIDATE_STATUSES, CANDIDATE_STATUS_LABELS, FIRST_INTERVIEW_STAGE, IN_PROCESS, INTERVIEW_STAGES, INTERVIEW_STAGE_LABELS, ROLE_STATUSES, } from '@kelpie/schemas';
+export type { CandidateStatus, InterviewStage, RoleStatus } from '@kelpie/schemas';
+/** An opening the workspace is hiring for. Candidates attach here, never to Person. */
+export declare const roles: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "roles";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "roles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "roles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "roles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "roles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "roles";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "roles";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        searchVector: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "roles";
+            dataType: "custom";
+            columnType: "PgCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: {
+                type: 'always';
+            };
+        }, {}, {
+            pgColumnBuilderBrand: 'PgCustomColumnBuilderBrand';
+        }>;
+    };
+    dialect: 'pg';
+}>;
+/**
+ * The Person-to-Role link. Pipeline state lives here.
+ *
+ * `interview_stage` is null unless `status` is `in_process`. That rule is
+ * enforced in the service layer, mirroring the mockup's `candidatePatchForStatus`,
+ * because a check constraint cannot express it without pinning the transition
+ * order too.
+ */
+export declare const candidates: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "candidates";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "candidates";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "candidates";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        roleId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "role_id";
+            tableName: "candidates";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        personId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "person_id";
+            tableName: "candidates";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "candidates";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        interviewStage: import("drizzle-orm/pg-core").PgColumn<{
+            name: "interview_stage";
+            tableName: "candidates";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        referrerPersonId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "referrer_person_id";
+            tableName: "candidates";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "candidates";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "candidates";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/modules/hiring/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/hiring/schema.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAElF,uFAAuF;AACvF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBjB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BtB,CAAA"}

package/dist/modules/hiring/schema.js

@@ -0,0 +1,62 @@
+import { CANDIDATE_STATUSES, INTERVIEW_STAGES, ROLE_STATUSES } from '@kelpie/schemas';
+import { sql } from 'drizzle-orm';
+import { check, index, pgTable, text, unique } from 'drizzle-orm/pg-core';
+import { checkOneOf, createdAt, oneOf, primaryId, searchVector, updatedAt, } from '../../lib/columns.js';
+import { people } from '../people/schema.js';
+import { workspaces } from '../workspace/schema.js';
+/**
+ * The value sets come from `@kelpie/schemas`, so these check constraints, the
+ * routes' Zod enums, and the browser's dropdowns are one list rather than three
+ * copies. Re-exported because `service.ts` and `routes.ts` read them from here,
+ * and the tables they constrain are the reason they matter.
+ */
+export { CANDIDATE_STATUSES, CANDIDATE_STATUS_LABELS, FIRST_INTERVIEW_STAGE, IN_PROCESS, INTERVIEW_STAGES, INTERVIEW_STAGE_LABELS, ROLE_STATUSES, } from '@kelpie/schemas';
+/** An opening the workspace is hiring for. Candidates attach here, never to Person. */
+export const roles = pgTable('roles', {
+    id: primaryId(),
+    workspaceId: text('workspace_id')
+        .notNull()
+        .references(() => workspaces.id, { onDelete: 'cascade' }),
+    title: text('title').notNull(),
+    status: text('status').notNull(),
+    createdAt: createdAt(),
+    updatedAt: updatedAt(),
+    searchVector: searchVector(() => [{ column: roles.title, weight: 'A' }]),
+}, (table) => [
+    index('roles_workspace_idx').on(table.workspaceId),
+    index('roles_search_idx').using('gin', table.searchVector),
+    checkOneOf('roles_status_check', table.status, ROLE_STATUSES),
+]);
+/**
+ * The Person-to-Role link. Pipeline state lives here.
+ *
+ * `interview_stage` is null unless `status` is `in_process`. That rule is
+ * enforced in the service layer, mirroring the mockup's `candidatePatchForStatus`,
+ * because a check constraint cannot express it without pinning the transition
+ * order too.
+ */
+export const candidates = pgTable('candidates', {
+    id: primaryId(),
+    workspaceId: text('workspace_id')
+        .notNull()
+        .references(() => workspaces.id, { onDelete: 'cascade' }),
+    roleId: text('role_id')
+        .notNull()
+        .references(() => roles.id, { onDelete: 'cascade' }),
+    personId: text('person_id')
+        .notNull()
+        .references(() => people.id, { onDelete: 'cascade' }),
+    status: text('status').notNull(),
+    interviewStage: text('interview_stage'),
+    referrerPersonId: text('referrer_person_id').references(() => people.id, {
+        onDelete: 'restrict',
+    }),
+    createdAt: createdAt(),
+    updatedAt: updatedAt(),
+}, (table) => [
+    unique('candidates_role_person_key').on(table.roleId, table.personId),
+    index('candidates_workspace_idx').on(table.workspaceId),
+    checkOneOf('candidates_status_check', table.status, CANDIDATE_STATUSES),
+    check('candidates_interview_stage_check', sql `${table.interviewStage} is null or ${oneOf('candidates_interview_stage_check', table.interviewStage, INTERVIEW_STAGES)}`),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/modules/hiring/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/modules/hiring/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EACL,UAAU,EACV,SAAS,EACT,KAAK,EACL,SAAS,EACT,YAAY,EACZ,SAAS,GACV,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD;;;;;GAKG;AACH,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,GACd,MAAM,iBAAiB,CAAA;AAGxB,uFAAuF;AACvF,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAC1B,OAAO,EACP;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,SAAS,EAAE,SAAS,EAAE;IACtB,SAAS,EAAE,SAAS,EAAE;IACtB,YAAY,EAAE,YAAY,CAAC,GAAgC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;CACtG,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;IAClD,KAAK,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;IAC1D,UAAU,CAAC,oBAAoB,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC;CAC9D,CACF,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAC/B,YAAY,EACZ;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;SACpB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtD,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;SACxB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACvD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC;IACvC,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE;QACvE,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,SAAS,EAAE,SAAS,EAAE;IACtB,SAAS,EAAE,SAAS,EAAE;CACvB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,MAAM,CAAC,4BAA4B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;IACrE,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;IACvD,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACvE,KAAK,CACH,kCAAkC,EAClC,GAAG,CAAA,GAAG,KAAK,CAAC,cAAc,eAAe,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,cAAc,EAAE,gBAAgB,CAAC,EAAE,CAC7H;CACF,CACF,CAAA"}

package/dist/modules/hiring/tools.d.ts

@@ -0,0 +1,8 @@
+import type { McpToolRegistry } from '../../runtime/module.ts';
+import type { CandidatesService } from './candidates.ts';
+import type { RolesService } from './roles.ts';
+export declare function registerHiringTools(mcp: McpToolRegistry, services: {
+    readonly roles: RolesService;
+    readonly candidates: CandidatesService;
+}): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/modules/hiring/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/modules/hiring/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AA8B9C,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,GACjF,IAAI,CAkCN"}

package/dist/modules/hiring/tools.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { enumSetArg, idArg, idSetArg, listWindowShape, registerCrudTools, termArg, toSet } from '../crudTools.js';
+import { candidateResponse, createCandidateBody, createRoleBody, roleResponse, toCreateCandidateInput, toCreateRoleInput, toUpdateCandidateInput, toUpdateRoleInput, updateCandidateBody, updateRoleBody, } from './routes.js';
+import { CANDIDATE_STATUSES, ROLE_STATUSES } from './schema.js';
+/** `roles_*` and `candidates_*`. Same schemas and mappers as `/v1/roles` and `/v1/candidates`. */
+const roleListArgs = z.strictObject({
+    ...listWindowShape,
+    q: termArg,
+    status: enumSetArg(ROLE_STATUSES).optional().describe('open, closed, or both.'),
+});
+const candidateListArgs = z.strictObject({
+    ...listWindowShape,
+    role_id: idSetArg.optional().describe('One role\'s pipeline.'),
+    person_id: idSetArg.optional().describe('Every role these people are up for.'),
+    status: enumSetArg(CANDIDATE_STATUSES).optional().describe('The candidacy\'s pipeline state.'),
+});
+export function registerHiringTools(mcp, services) {
+    registerCrudTools(mcp, {
+        resource: 'roles',
+        subject: 'role',
+        about: 'An opening this workspace is hiring for. Candidates attach to a role, never to a person.',
+        service: services.roles,
+        render: roleResponse,
+        listArgs: roleListArgs,
+        toFilters: (args) => ({ term: args.q, statuses: toSet(args.status) }),
+        createArgs: createRoleBody,
+        toCreateInput: toCreateRoleInput,
+        updateArgs: updateRoleBody.extend({ id: idArg }),
+        toUpdateInput: toUpdateRoleInput,
+    });
+    registerCrudTools(mcp, {
+        resource: 'candidates',
+        subject: 'candidate',
+        about: 'One person\'s candidacy for one role: status, interview stage while in process, ' +
+            'and who referred them. Interview notes attach here, not to the person.',
+        service: services.candidates,
+        render: candidateResponse,
+        listArgs: candidateListArgs,
+        toFilters: (args) => ({
+            roleIds: toSet(args.role_id),
+            personIds: toSet(args.person_id),
+            statuses: toSet(args.status),
+        }),
+        createArgs: createCandidateBody,
+        toCreateInput: toCreateCandidateInput,
+        updateArgs: updateCandidateBody.extend({ id: idArg }),
+        toUpdateInput: toUpdateCandidateInput,
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/modules/hiring/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/modules/hiring/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAGjH,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE/D,kGAAkG;AAElG,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IAClC,GAAG,eAAe;IAClB,CAAC,EAAE,OAAO;IACV,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAChF,CAAC,CAAA;AAEF,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC;IACvC,GAAG,eAAe;IAClB,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC9D,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC9E,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAC/F,CAAC,CAAA;AAEF,MAAM,UAAU,mBAAmB,CACjC,GAAoB,EACpB,QAAkF;IAElF,iBAAiB,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,0FAA0F;QACjG,OAAO,EAAE,QAAQ,CAAC,KAAK;QACvB,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,UAAU,EAAE,cAAc;QAC1B,aAAa,EAAE,iBAAiB;QAChC,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAChD,aAAa,EAAE,iBAAiB;KACjC,CAAC,CAAA;IAEF,iBAAiB,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,WAAW;QACpB,KAAK,EACH,kFAAkF;YAClF,wEAAwE;QAC1E,OAAO,EAAE,QAAQ,CAAC,UAAU;QAC5B,MAAM,EAAE,iBAAiB;QACzB,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;YAC5B,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;YAChC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;SAC7B,CAAC;QACF,UAAU,EAAE,mBAAmB;QAC/B,aAAa,EAAE,sBAAsB;QACrC,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACrD,aAAa,EAAE,sBAAsB;KACtC,CAAC,CAAA;AACJ,CAAC"}

package/dist/modules/import-export/csv.d.ts

@@ -0,0 +1,47 @@
+/**
+ * RFC 4180 CSV, read and written.
+ *
+ * Ported from `mockups/src/data/importExport.ts` with two corrections. A blank
+ * line no longer shifts the numbering of every row after it, because a row
+ * number is what an error message points the user at. And a file whose header
+ * row repeats a name is refused rather than silently read as its last
+ * occurrence, because a `column_map` names a header and there would be no way to
+ * say which of the two it meant.
+ *
+ * Pure: no I/O, no clock. The whole of it is unit-tested.
+ */
+/**
+ * The digest a job keeps instead of the file.
+ *
+ * A dry run records this, and the commit that carries the file back is checked
+ * against it. Storing 64 characters rather than up to ten megabytes is the
+ * point: a forecast nobody committed should not cost a workspace the file.
+ *
+ * Not a security control. It answers "is this the file I forecast", not "who
+ * sent it", so a plain digest is right and `lib/tokens.ts` — which is about
+ * bearer secrets — is not the place for it.
+ */
+export declare function fileDigest(csv: string): string;
+export interface CsvRow {
+    /** The line in the file, counting the header as line 1. */
+    readonly number: number;
+    /** Source header → cell. Cells are trimmed; a short row's missing cells are `''`. */
+    readonly values: Readonly<Record<string, string>>;
+}
+export interface ParsedCsv {
+    readonly headers: readonly string[];
+    readonly rows: readonly CsvRow[];
+}
+export declare class CsvFormatError extends Error {
+    constructor(message: string);
+}
+/**
+ * @throws CsvFormatError when the file has no header row, when a header is
+ *   blank, or when two headers are the same. Each of those makes a `column_map`
+ *   unanswerable rather than merely inconvenient.
+ */
+export declare function parseCsv(text: string): ParsedCsv;
+/** One CSV line, terminated. Rows are written a line at a time so an export can stream. */
+export declare function csvLine(cells: readonly string[]): string;
+export declare function serialiseCsv(headers: readonly string[], rows: readonly (readonly string[])[]): string;
+//# sourceMappingURL=csv.d.ts.map

package/dist/modules/import-export/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/modules/import-export/csv.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,MAAM,WAAW,MAAM;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA4ED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAsChD;AAMD,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAExD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,CAErG"}

package/dist/modules/import-export/csv.js

@@ -0,0 +1,138 @@
+import { createHash } from 'node:crypto';
+/**
+ * RFC 4180 CSV, read and written.
+ *
+ * Ported from `mockups/src/data/importExport.ts` with two corrections. A blank
+ * line no longer shifts the numbering of every row after it, because a row
+ * number is what an error message points the user at. And a file whose header
+ * row repeats a name is refused rather than silently read as its last
+ * occurrence, because a `column_map` names a header and there would be no way to
+ * say which of the two it meant.
+ *
+ * Pure: no I/O, no clock. The whole of it is unit-tested.
+ */
+/**
+ * The digest a job keeps instead of the file.
+ *
+ * A dry run records this, and the commit that carries the file back is checked
+ * against it. Storing 64 characters rather than up to ten megabytes is the
+ * point: a forecast nobody committed should not cost a workspace the file.
+ *
+ * Not a security control. It answers "is this the file I forecast", not "who
+ * sent it", so a plain digest is right and `lib/tokens.ts` — which is about
+ * bearer secrets — is not the place for it.
+ */
+export function fileDigest(csv) {
+    return createHash('sha256').update(csv, 'utf8').digest('hex');
+}
+export class CsvFormatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CsvFormatError';
+    }
+}
+/** A leading byte-order mark, which a spreadsheet export routinely writes. */
+const BYTE_ORDER_MARK = /^/u;
+/**
+ * Splits the text into physical cells, honouring quoted fields.
+ *
+ * A quote inside a quoted field is doubled (`""`), and a newline inside one does
+ * not end the record — which is why this cannot be a `split` on lines.
+ */
+function splitRows(text) {
+    const rows = [];
+    let row = [];
+    let cell = '';
+    let inQuotes = false;
+    const input = text.replace(BYTE_ORDER_MARK, '');
+    for (let index = 0; index < input.length; index += 1) {
+        const character = input[index];
+        if (inQuotes) {
+            if (character !== '"') {
+                cell += character;
+                continue;
+            }
+            if (input[index + 1] === '"') {
+                cell += '"';
+                index += 1;
+            }
+            else {
+                inQuotes = false;
+            }
+            continue;
+        }
+        if (character === '"') {
+            inQuotes = true;
+            continue;
+        }
+        if (character === ',') {
+            row.push(cell);
+            cell = '';
+            continue;
+        }
+        if (character === '\n') {
+            row.push(cell);
+            rows.push(row);
+            row = [];
+            cell = '';
+            continue;
+        }
+        // A bare CR belongs to the CRLF that ends a line; a lone one is not a cell.
+        if (character === '\r') {
+            continue;
+        }
+        cell += character;
+    }
+    if (cell.length > 0 || row.length > 0) {
+        row.push(cell);
+        rows.push(row);
+    }
+    return rows;
+}
+function isBlank(cells) {
+    return cells.every((cell) => cell.trim().length === 0);
+}
+/**
+ * @throws CsvFormatError when the file has no header row, when a header is
+ *   blank, or when two headers are the same. Each of those makes a `column_map`
+ *   unanswerable rather than merely inconvenient.
+ */
+export function parseCsv(text) {
+    const [headerCells, ...dataCells] = splitRows(text);
+    if (headerCells === undefined || isBlank(headerCells)) {
+        throw new CsvFormatError('The file has no header row');
+    }
+    const headers = headerCells.map((header) => header.trim());
+    const blank = headers.findIndex((header) => header.length === 0);
+    if (blank >= 0) {
+        throw new CsvFormatError(`Column ${String(blank + 1)} of the header row has no name`);
+    }
+    const duplicate = headers.find((header, index) => headers.indexOf(header) !== index);
+    if (duplicate !== undefined) {
+        throw new CsvFormatError(`The header "${duplicate}" appears more than once`);
+    }
+    const rows = [];
+    dataCells.forEach((cells, index) => {
+        if (isBlank(cells)) {
+            return;
+        }
+        const values = {};
+        headers.forEach((header, column) => {
+            values[header] = (cells[column] ?? '').trim();
+        });
+        // +2, not +1: the header is line 1 and this index counts from the line after.
+        rows.push({ number: index + 2, values });
+    });
+    return { headers, rows };
+}
+function escapeCell(value) {
+    return /["\n\r,]/u.test(value) ? `"${value.replace(/"/gu, '""')}"` : value;
+}
+/** One CSV line, terminated. Rows are written a line at a time so an export can stream. */
+export function csvLine(cells) {
+    return `${cells.map(escapeCell).join(',')}\n`;
+}
+export function serialiseCsv(headers, rows) {
+    return [headers, ...rows].map(csvLine).join('');
+}
+//# sourceMappingURL=csv.js.map

package/dist/modules/import-export/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/modules/import-export/csv.ts"],"names":[],"mappings":"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"}