@wictorwilen/cocogen 1.0.0

package/dist/typespec/state.d.ts

@@ -0,0 +1,37 @@
+export declare const COCOGEN_STATE_ITEM_MODELS: unique symbol;
+export declare const COCOGEN_STATE_ID_PROPERTIES: unique symbol;
+export declare const COCOGEN_STATE_CONTENT_PROPERTIES: unique symbol;
+export declare const COCOGEN_STATE_CONNECTION_SETTINGS: unique symbol;
+export declare const COCOGEN_STATE_PROFILE_SOURCE_SETTINGS: unique symbol;
+export declare const COCOGEN_STATE_PROPERTY_LABELS: unique symbol;
+export declare const COCOGEN_STATE_PROPERTY_ALIASES: unique symbol;
+export declare const COCOGEN_STATE_PROPERTY_NAME_OVERRIDES: unique symbol;
+export declare const COCOGEN_STATE_PROPERTY_DESCRIPTIONS: unique symbol;
+export declare const COCOGEN_STATE_PROPERTY_SEARCH: unique symbol;
+export declare const COCOGEN_STATE_PROPERTY_SOURCE: unique symbol;
+export declare const COCOGEN_STATE_PROPERTY_PERSON_FIELDS: unique symbol;
+export type CocogenConnectionSettings = {
+    contentCategory?: "uncategorized" | "knowledgeBase" | "wikis" | "fileRepository" | "qna" | "crm" | "dashboard" | "people" | "media" | "email" | "messaging" | "meetingTranscripts" | "taskManagement" | "learningManagement";
+    connectionId?: string;
+    connectionDescription?: string;
+};
+export type CocogenProfileSourceSettings = {
+    webUrl: string;
+    displayName?: string;
+    priority?: "first" | "last";
+};
+export type CocogenSearchFlags = {
+    searchable?: boolean;
+    queryable?: boolean;
+    retrievable?: boolean;
+    refinable?: boolean;
+    exactMatchRequired?: boolean;
+};
+export type CocogenSourceSettings = {
+    csv?: string;
+};
+export type CocogenPersonEntityField = {
+    path: string;
+    source: CocogenSourceSettings | string;
+};
+//# sourceMappingURL=state.d.ts.map

package/dist/typespec/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/typespec/state.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,eAAgD,CAAC;AACvF,eAAO,MAAM,2BAA2B,eAAkD,CAAC;AAC3F,eAAO,MAAM,gCAAgC,eAAuD,CAAC;AACrG,eAAO,MAAM,iCAAiC,eAAwD,CAAC;AACvG,eAAO,MAAM,qCAAqC,eAA2D,CAAC;AAC9G,eAAO,MAAM,6BAA6B,eAAoD,CAAC;AAC/F,eAAO,MAAM,8BAA8B,eAAqD,CAAC;AACjG,eAAO,MAAM,qCAAqC,eAA2D,CAAC;AAC9G,eAAO,MAAM,mCAAmC,eAA0D,CAAC;AAC3G,eAAO,MAAM,6BAA6B,eAAoD,CAAC;AAC/F,eAAO,MAAM,6BAA6B,eAAoD,CAAC;AAC/F,eAAO,MAAM,oCAAoC,eAA0D,CAAC;AAE5G,MAAM,MAAM,yBAAyB,GAAG;IACtC,eAAe,CAAC,EACZ,eAAe,GACf,eAAe,GACf,OAAO,GACP,gBAAgB,GAChB,KAAK,GACL,KAAK,GACL,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,WAAW,GACX,oBAAoB,GACpB,gBAAgB,GAChB,oBAAoB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC;CACxC,CAAC"}

package/dist/typespec/state.js

@@ -0,0 +1,13 @@
+export const COCOGEN_STATE_ITEM_MODELS = Symbol.for("@wictorwilen/cocogen/itemModels");
+export const COCOGEN_STATE_ID_PROPERTIES = Symbol.for("@wictorwilen/cocogen/idProperties");
+export const COCOGEN_STATE_CONTENT_PROPERTIES = Symbol.for("@wictorwilen/cocogen/contentProperties");
+export const COCOGEN_STATE_CONNECTION_SETTINGS = Symbol.for("@wictorwilen/cocogen/connectionSettings");
+export const COCOGEN_STATE_PROFILE_SOURCE_SETTINGS = Symbol.for("@wictorwilen/cocogen/profileSourceSettings");
+export const COCOGEN_STATE_PROPERTY_LABELS = Symbol.for("@wictorwilen/cocogen/propertyLabels");
+export const COCOGEN_STATE_PROPERTY_ALIASES = Symbol.for("@wictorwilen/cocogen/propertyAliases");
+export const COCOGEN_STATE_PROPERTY_NAME_OVERRIDES = Symbol.for("@wictorwilen/cocogen/propertyNameOverrides");
+export const COCOGEN_STATE_PROPERTY_DESCRIPTIONS = Symbol.for("@wictorwilen/cocogen/propertyDescriptions");
+export const COCOGEN_STATE_PROPERTY_SEARCH = Symbol.for("@wictorwilen/cocogen/propertySearch");
+export const COCOGEN_STATE_PROPERTY_SOURCE = Symbol.for("@wictorwilen/cocogen/propertySource");
+export const COCOGEN_STATE_PROPERTY_PERSON_FIELDS = Symbol.for("@wictorwilen/cocogen/propertyPersonFields");
+//# sourceMappingURL=state.js.map

package/dist/typespec/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/typespec/state.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AACvF,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AACrG,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACvG,MAAM,CAAC,MAAM,qCAAqC,GAAG,MAAM,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;AAC9G,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,qCAAqC,GAAG,MAAM,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;AAC9G,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AAC3G,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,oCAAoC,GAAG,MAAM,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC"}

package/dist/validate/validator.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorIr } from "../ir.js";
+export type ValidationSeverity = "error" | "warning";
+export type ValidationIssue = {
+    severity: ValidationSeverity;
+    message: string;
+    hint?: string;
+};
+export declare function validateIr(ir: ConnectorIr): ValidationIssue[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/validate/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validate/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,UAAU,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAgDF,wBAAgB,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,EAAE,CA6K7D"}

package/dist/validate/validator.js

@@ -0,0 +1,204 @@
+function isSearchableType(type) {
+    return type === "string" || type === "stringCollection";
+}
+function isPeopleLabeled(labels) {
+    return labels.some((l) => l.startsWith("person"));
+}
+function hasSearchFlags(flags) {
+    return Object.values(flags).some((value) => Boolean(value));
+}
+const PEOPLE_LABELS = new Set([
+    "personAccount",
+    "personName",
+    "personCurrentPosition",
+    "personAddresses",
+    "personEmails",
+    "personPhones",
+    "personAwards",
+    "personCertifications",
+    "personProjects",
+    "personSkills",
+    "personWebAccounts",
+    "personWebSite",
+    "personAnniversaries",
+    "personNote",
+]);
+const PEOPLE_ENTITY_BY_LABEL = new Map([
+    ["personAccount", "userAccountInformation"],
+    ["personName", "personName"],
+    ["personCurrentPosition", "workPosition"],
+    ["personAddresses", "itemAddress"],
+    ["personEmails", "itemEmail"],
+    ["personPhones", "itemPhone"],
+    ["personAwards", "personAward"],
+    ["personCertifications", "personCertification"],
+    ["personProjects", "projectParticipation"],
+    ["personSkills", "skillProficiency"],
+    ["personWebAccounts", "webAccount"],
+    ["personWebSite", "personWebsite"],
+    ["personAnniversaries", "personAnniversary"],
+    ["personNote", "personAnnotation"],
+]);
+export function validateIr(ir) {
+    const issues = [];
+    // Graph constraints
+    if (ir.properties.length > 128) {
+        issues.push({
+            severity: "error",
+            message: `Too many schema properties (${ir.properties.length}). Microsoft Graph external connections allow max 128.`,
+            hint: "Remove or consolidate properties in the item model.",
+        });
+    }
+    const seenNames = new Set();
+    for (const prop of ir.properties) {
+        if (seenNames.has(prop.name)) {
+            issues.push({
+                severity: "error",
+                message: `Duplicate property name '${prop.name}' after applying @coco.name overrides.`,
+                hint: "Use @coco.name(\"...\") to provide a shorter name.",
+            });
+        }
+        seenNames.add(prop.name);
+        if (prop.name.length > 32) {
+            issues.push({
+                severity: "error",
+                message: `Property '${prop.name}' is too long (${prop.name.length}). Graph schema names must be <= 32 characters.`,
+                hint: "Use @coco.name(\"...\") to provide a shorter name.",
+            });
+        }
+        if (!/^[A-Za-z0-9]+$/.test(prop.name)) {
+            issues.push({
+                severity: "error",
+                message: `Property '${prop.name}' contains invalid characters. Graph schema names must be alphanumeric only.`,
+                hint: "Use @coco.name(\"...\") to provide an alphanumeric name.",
+            });
+        }
+        if (prop.search.searchable) {
+            if (!isSearchableType(prop.type)) {
+                issues.push({
+                    severity: "error",
+                    message: `Property '${prop.name}' is marked searchable but has type '${prop.type}'. Only string/stringCollection can be searchable.`,
+                    hint: "Remove searchable=true or change the property to string/stringCollection.",
+                });
+            }
+            if (prop.search.refinable) {
+                issues.push({
+                    severity: "error",
+                    message: `Property '${prop.name}' is both searchable and refinable. This combination is not supported.`,
+                    hint: "Remove refinable=true or searchable=true.",
+                });
+            }
+        }
+        if (prop.type === "principal" && prop.search.searchable) {
+            issues.push({
+                severity: "error",
+                message: `Property '${prop.name}' has type 'principal' and cannot be marked searchable.`,
+                hint: "Remove searchable=true for this property.",
+            });
+        }
+    }
+    const idProp = ir.properties.find((p) => p.name === ir.item.idPropertyName);
+    if (!idProp) {
+        issues.push({
+            severity: "error",
+            message: `Internal mismatch: id property '${ir.item.idPropertyName}' is not present in properties list.`,
+            hint: "This is a cocogen bug. Please file an issue with your schema.",
+        });
+    }
+    else if (idProp.type !== "string") {
+        issues.push({
+            severity: "error",
+            message: `@coco.id property '${idProp.name}' must be a string (external item ids are strings). Found '${idProp.type}'.`,
+            hint: "Change the TypeSpec property type to 'string'.",
+        });
+    }
+    if (ir.item.contentPropertyName) {
+        const contentProp = ir.properties.find((p) => p.name === ir.item.contentPropertyName);
+        if (!contentProp) {
+            issues.push({
+                severity: "error",
+                message: `Internal mismatch: content property '${ir.item.contentPropertyName}' is not present in properties list.`,
+                hint: "This is a cocogen bug. Please file an issue with your schema.",
+            });
+        }
+        else if (contentProp.type !== "string") {
+            issues.push({
+                severity: "error",
+                message: `@coco.content property '${contentProp.name}' must be a string (full-text content value). Found '${contentProp.type}'.`,
+                hint: "Change the TypeSpec property type to 'string'.",
+            });
+        }
+    }
+    // People connectors rules (preview)
+    if (ir.connection.contentCategory === "people") {
+        if (ir.connection.profileSource && ir.connection.profileSource.webUrl.trim().length === 0) {
+            issues.push({
+                severity: "error",
+                message: "@coco.profileSource requires a non-empty webUrl.",
+                hint: "Set webUrl to an HTTPS link to the source system or info page.",
+            });
+        }
+        if (ir.item.contentPropertyName) {
+            issues.push({
+                severity: "error",
+                message: `People connectors do not support externalItem.content. Remove @coco.content from '${ir.item.contentPropertyName}'.`,
+                hint: "For people connectors, represent all searchable/retrievable data as schema properties instead of externalItem.content.",
+            });
+        }
+        const personAccountProps = ir.properties.filter((p) => p.labels.includes("personAccount"));
+        if (personAccountProps.length !== 1) {
+            issues.push({
+                severity: "error",
+                message: personAccountProps.length === 0
+                    ? "People connectors require exactly one property labeled 'personAccount', but none was found."
+                    : `People connectors require exactly one property labeled 'personAccount', but found ${personAccountProps.length} (${personAccountProps
+                        .map((p) => p.name)
+                        .join(", ")}).`,
+                hint: "Add @coco.label(\"personAccount\") to the property that identifies the person account.",
+            });
+        }
+        for (const prop of ir.properties) {
+            if (hasSearchFlags(prop.search)) {
+                issues.push({
+                    severity: "warning",
+                    message: `People connectors ignore @coco.search flags (property '${prop.name}').`,
+                    hint: "Remove @coco.search from people connector schemas to avoid confusion.",
+                });
+            }
+            if (!isPeopleLabeled(prop.labels))
+                continue;
+            for (const label of prop.labels) {
+                if (label.startsWith("person") && !PEOPLE_LABELS.has(label)) {
+                    issues.push({
+                        severity: "error",
+                        message: `People connector label '${label}' is not supported.`,
+                        hint: "Use a supported people label like personCurrentPosition or personEmails.",
+                    });
+                }
+            }
+            if (prop.type !== "string" && prop.type !== "stringCollection") {
+                issues.push({
+                    severity: "error",
+                    message: `People-labeled property '${prop.name}' must be string or stringCollection. Found '${prop.type}'.`,
+                    hint: "For People connectors, people-domain labeled properties must contain JSON-serialized profile entity objects in strings.",
+                });
+            }
+            if (!prop.personEntity) {
+                issues.push({
+                    severity: "error",
+                    message: `People-labeled property '${prop.name}' must define @coco.source(..., to) mappings.`,
+                    hint: "Add one or more @coco.source(" + "\"column\", \"entity.path\"" + ") decorators to build the required JSON entity payload.",
+                });
+            }
+        }
+    }
+    if (ir.connection.profileSource && ir.connection.contentCategory !== "people") {
+        issues.push({
+            severity: "error",
+            message: "@coco.profileSource can only be used with people connectors.",
+            hint: "Set @coco.connection({ contentCategory: \"people\" }) or remove @coco.profileSource.",
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=validator.js.map

package/dist/validate/validator.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@wictorwilen/cocogen",
+  "version": "1.0.0",
+  "description": "TypeSpec-driven Microsoft Copilot connector generator",
+  "license": "MIT",
+  "author": "Wictor Wilén <wictor@wictorwilen.se>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wictorwilen/cocogen.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wictorwilen/cocogen/issues"
+  },
+  "homepage": "https://github.com/wictorwilen/cocogen#readme",
+  "type": "module",
+  "tspMain": "./typespec/main.tsp",
+  "bin": {
+    "cocogen": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "typespec",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "RELEASING.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node ./scripts/copy-init-templates.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pretest": "npm run typecheck && npm run build",
+    "test": "vitest run",
+    "test:coverage": "vitest run tests/unit --coverage",
+    "test:watch": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "pretest:e2e": "npm run build",
+    "test:e2e": "vitest run tests/e2e"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@typespec/compiler": "^1.8.0",
+    "@inquirer/prompts": "^7.2.1",
+    "commander": "^14.0.2",
+    "ejs": "^4.0.1",
+    "ora": "^9.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@types/ejs": "^3.1.5",
+    "@vitest/coverage-v8": "^4.0.17",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  }
+}

package/typespec/main.tsp

@@ -0,0 +1,117 @@
+// TypeSpec library entrypoint for @wictorwilen/cocogen
+//
+// This file defines the decorators consumed by cocogen.
+// The implementations live in the JS module for this package.
+
+import "./tsp-index.js";
+
+using TypeSpec.Reflection;
+
+namespace coco {
+  model ConnectionSettings {
+    contentCategory?: ContentCategory;
+    connectionId?: string;
+    connectionDescription?: string;
+  }
+
+  model ProfileSourceSettings {
+    webUrl: string;
+    displayName?: string;
+    priority?: "first" | "last";
+  }
+
+  model SearchFlags {
+    searchable?: boolean;
+    queryable?: boolean;
+    retrievable?: boolean;
+    refinable?: boolean;
+    exactMatchRequired?: boolean;
+  }
+
+  model ContentSettings {
+    type?: "text";
+  }
+
+  model SourceSettings {
+    csv?: string;
+  }
+
+
+  alias ContentCategory =
+    | "uncategorized"
+    | "knowledgeBase"
+    | "wikis"
+    | "fileRepository"
+    | "qna"
+    | "crm"
+    | "dashboard"
+    | "people"
+    | "media"
+    | "email"
+    | "messaging"
+    | "meetingTranscripts"
+    | "taskManagement"
+    | "learningManagement";
+
+  alias Label =
+    | "title"
+    | "url"
+    | "createdDateTime"
+    | "lastModifiedDateTime"
+    | "fileExtension"
+    | "iconUrl"
+    | "containerName"
+    | "containerUrl"
+    | "createdBy"
+    | "lastModifiedBy"
+    | "personAccount"
+    | "personName"
+    | "personCurrentPosition"
+    | "personAddresses"
+    | "personEmails"
+    | "personPhones"
+    | "personAwards"
+    | "personCertifications"
+    | "personProjects"
+    | "personSkills"
+    | "personWebAccounts"
+    | "personWebSite"
+    | "personAnniversaries"
+    | "personNote";
+
+  // Marks the external item model.
+  extern dec item(target: Model);
+
+  // Marks the item ID field.
+  extern dec id(target: ModelProperty);
+
+  // Schema labels (Graph externalConnectors.label values).
+  extern dec label(target: ModelProperty, value: Label);
+
+  // Aliases for schema fields.
+  extern dec aliases(target: ModelProperty, value: string);
+
+  // Schema property description (emitted to Microsoft Graph schema property.description).
+  extern dec description(target: ModelProperty, value: string);
+
+  // Field rename for Graph schema constraints.
+  extern dec name(target: ModelProperty, value: string);
+
+  // Connection-level settings.
+  extern dec connection(target: Model, settings: ConnectionSettings);
+
+  // People connector profile source settings.
+  extern dec profileSource(target: Model, settings: ProfileSourceSettings);
+
+  // Search flags.
+  extern dec search(target: ModelProperty, flags: SearchFlags);
+
+  // Marks an item content field for externalItem.content.value.
+  extern dec content(target: ModelProperty, settings?: ContentSettings);
+
+  // Maps a source field (CSV header) to a property or entity path.
+  extern dec source(target: ModelProperty, from: SourceSettings | string, to?: string);
+
+  // A custom scalar we map to Graph schema propertyType = principal.
+  scalar Principal;
+}

package/typespec/tsp-index.js

@@ -0,0 +1,6 @@
+// JS entrypoint for the TypeSpec library.
+//
+// TypeSpec loads this file from `typespec/main.tsp` to provide implementations
+// for the `extern dec` declarations.
+
+export * from "../dist/typespec/decorators.js";