@vicacha-devs/strapi-plugin-global-search 0.0.0-stage → 2.0.3

package/dist/server/types.d.ts

@@ -0,0 +1,195 @@
+export interface PluginSettings {
+    minChars: number;
+    debounce: number;
+    perTypeLimit: number;
+    maxResults: number;
+    deep: boolean;
+    maxDepth: number;
+    includeDrafts: boolean;
+    includePluginContentTypes: boolean;
+    queryTimeout: number;
+    concurrency: number;
+    excludedContentTypes: string[];
+    excludedFields: string[];
+    displayFields: Record<string, string[]>;
+}
+export type ContentTypeKind = "collectionType" | "singleType";
+export interface ContentTypeDescriptor {
+    uid: string;
+    kind: ContentTypeKind | string;
+    displayName: string;
+    apiName?: string;
+    mainField: string;
+    mainFieldSearchable?: boolean;
+    idFields: string[];
+    topLevelFields: string[];
+    nestedFields: string[];
+    displayFields?: string[];
+    localized: boolean;
+    draftAndPublish: boolean;
+    searchable: boolean;
+}
+export interface RankedHit {
+    tier: number;
+    tierLabel: string;
+    matchedField: string | null;
+    matchedFieldLabel: string | null;
+    matchedSnippet: string | null;
+    exactCase: boolean;
+    valueLength: number;
+    contentTypeUid: string;
+    contentTypeLabel: string;
+    kind: string;
+    id: string | number;
+    documentId: string | null;
+    title: string;
+    mainField: string;
+    extra: Array<{
+        field: string;
+        value: unknown;
+    }>;
+    locale: string | null;
+    status: "published" | "draft" | null;
+    updatedAt: string | null;
+    adminUrl: string;
+}
+export interface SearchParams {
+    query?: string;
+    types?: string[];
+    locale?: string;
+    page?: number;
+    pageSize?: number;
+    userAbility?: {
+        can: (action: string, subject: string) => boolean;
+    } | null;
+}
+export interface SearchResult {
+    query: string;
+    results: RankedHit[];
+    groups: Array<{
+        uid: string;
+        label: string;
+        kind: string;
+        count: number;
+        truncated: boolean;
+    }>;
+    pagination: {
+        page: number;
+        pageSize: number;
+        total: number;
+        pageCount: number;
+    };
+    meta: {
+        searchedTypes: number;
+        truncatedTypes: string[];
+        failedTypes: Array<{
+            uid: string;
+            message: string;
+        }>;
+        minChars: number;
+        capped?: boolean;
+    };
+}
+export interface AttributeShape {
+    type?: string;
+    private?: boolean;
+    searchable?: boolean;
+    component?: string;
+    customField?: string;
+    relation?: string;
+    repeatable?: boolean;
+    components?: string[];
+}
+export interface ContentTypeShape {
+    uid: string;
+    kind?: string;
+    apiName?: string;
+    attributes?: Record<string, AttributeShape>;
+    info?: {
+        displayName?: string;
+        singularName?: string;
+    };
+    pluginOptions?: {
+        "i18n"?: {
+            localized?: boolean;
+        };
+        "content-manager"?: {
+            visible?: boolean;
+        };
+    };
+    options?: {
+        draftAndPublish?: boolean;
+    };
+}
+export interface StrapiPluginService {
+    findConfiguration: (contentType: {
+        uid: string;
+    }) => Promise<{
+        settings?: {
+            mainField?: string;
+        };
+    } | undefined>;
+    getSearchableContentTypes: (opts?: {
+        force?: boolean;
+    }) => Promise<ContentTypeDescriptor[]>;
+    getAllContentTypes: () => Promise<ContentTypeDescriptor[]>;
+    clearCache: () => void;
+    filterReadableTypes: (types: ContentTypeDescriptor[], userAbility?: {
+        can: (action: string, subject: string) => boolean;
+    } | null) => ContentTypeDescriptor[];
+    get: () => Promise<PluginSettings>;
+    set: (patch?: Partial<PluginSettings>) => Promise<PluginSettings>;
+    reset: () => Promise<PluginSettings>;
+    search: (params?: SearchParams) => Promise<SearchResult>;
+    buildParams: (descriptor: ContentTypeDescriptor, opts: {
+        query: string;
+        locale?: string;
+        limit: number;
+        includeDrafts: boolean;
+    }) => Record<string, unknown> | null;
+    score: (entry: unknown, descriptor: ContentTypeDescriptor, query: string) => Pick<RankedHit, "tier" | "tierLabel" | "matchedField" | "matchedFieldLabel" | "matchedSnippet" | "exactCase" | "valueLength">;
+    sort: (hits: RankedHit[]) => RankedHit[];
+}
+/** Minimal Strapi-like shape used by services */
+export interface StrapiLike {
+    contentTypes: Record<string, ContentTypeShape>;
+    components: Record<string, {
+        attributes?: Record<string, AttributeShape>;
+    }>;
+    config: {
+        get: (key: string, defaultValue?: unknown) => Record<string, unknown>;
+    };
+    store: (opts: {
+        type: string;
+        name: string;
+    }) => {
+        get: (opts: {
+            key: string;
+        }) => Promise<Record<string, unknown> | null | undefined>;
+        set: (opts: {
+            key: string;
+            value: unknown;
+        }) => Promise<void>;
+    };
+    log: {
+        debug: (msg: string) => void;
+        warn: (msg: string) => void;
+        error: (msg: string) => void;
+    };
+    plugin: (id: string) => {
+        service: (name: string) => StrapiPluginService;
+    };
+    documents: (uid: string) => {
+        findMany: (params: unknown) => Promise<unknown>;
+    };
+    admin?: {
+        services: {
+            permission: {
+                actionProvider: {
+                    registerMany: (actions: unknown[]) => void;
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

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

package/dist/server/utils/async.d.ts

@@ -0,0 +1,8 @@
+/** Rejects if `factory()` has not settled within `ms`. Always clears its timer. */
+export declare const withTimeout: <T>(factory: () => T | Promise<T>, ms: number, label: string) => Promise<T>;
+/**
+ * Runs `worker` over `items` with at most `concurrency` in flight, so an app with
+ * 60 content types cannot exhaust the database pool on a single keystroke.
+ */
+export declare const mapWithConcurrency: <T, R>(items: T[], concurrency: number, worker: (item: T, index: number) => Promise<R>) => Promise<R[]>;
+//# sourceMappingURL=async.d.ts.map

package/dist/server/utils/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../server/utils/async.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,SAAS,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC7B,IAAI,MAAM,EACV,OAAO,MAAM,KACZ,OAAO,CAAC,CAAC,CAcX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAU,CAAC,EAAE,CAAC,EAC3C,OAAO,CAAC,EAAE,EACV,aAAa,MAAM,EACnB,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAC7C,OAAO,CAAC,CAAC,EAAE,CAmBb,CAAC"}

package/dist/server/utils/constants.d.ts

@@ -0,0 +1,42 @@
+export declare const PLUGIN_ID = "global-search";
+/**
+ * Attribute types whose stored value is a plain string, i.e. the ones the query
+ * engine can match with `$containsi`.
+ */
+export declare const SEARCHABLE_SCALAR_TYPES: string[];
+/**
+ * Internal Strapi system/infrastructure plugin UID prefixes that should not be
+ * indexed as user-facing Content-Manager content types by default.
+ */
+export declare const SYSTEM_PLUGIN_PREFIXES: string[];
+/**
+ * Attribute types we deliberately never walk into.
+ * - dynamiczone / blocks: the query engine cannot filter polymorphic JSON.
+ * - relation / media: would explode the join graph; relations are shown, not searched.
+ */
+export declare const SKIPPED_ATTRIBUTE_TYPES: string[];
+/** Attribute names that must never leave the server, whatever their type. */
+export declare const BLOCKLISTED_ATTRIBUTE_NAMES: string[];
+/**
+ * String attributes that identify an entry. `id` is numeric and handled
+ * separately. `documentId` is always queried in Strapi 5 even when it is not
+ * declared on the schema.
+ */
+export declare const IDENTIFIER_FIELDS: string[];
+/** Used when the Content-Manager configuration has no mainField for a type. */
+export declare const MAIN_FIELD_FALLBACKS: string[];
+/** Ranking tiers — lower wins. Mirrors the documented ordering rule. */
+export declare const TIER: {
+    ID_EXACT: number;
+    ID_CONTAINS: number;
+    MAIN_EXACT: number;
+    MAIN_STARTS_WITH: number;
+    MAIN_CONTAINS: number;
+    FIELD_CONTAINS: number;
+    NESTED_CONTAINS: number;
+    UNKNOWN: number;
+};
+export declare const TIER_LABELS: Record<number, string>;
+export declare const MAX_QUERY_LENGTH = 200;
+export declare const SNIPPET_RADIUS = 45;
+//# sourceMappingURL=constants.d.ts.map

package/dist/server/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../server/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,kBAAkB,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,UAQnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAalC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,UAOnC,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,UAKvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAS7B,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,UAkBhC,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,IAAI;;;;;;;;;CAShB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,cAAc,KAAK,CAAC"}

package/dist/server/utils/text.d.ts

@@ -0,0 +1,20 @@
+export declare const sanitizeQuery: (raw: unknown) => string;
+/**
+ * Extracts human-readable text from ProseMirror / Tiptap JSON documents
+ * (`{ type: 'doc', content: [...] }` or `{ doc: { type: 'doc', content: [...] } }`),
+ * whether passed as an object or a serialized JSON string. Returns `null` if
+ * `value` is not a structured rich-text document.
+ */
+export declare const extractStructuredText: (value: unknown) => string | null;
+/** Plain-text projection of richtext/HTML/Markdown/ProseMirror JSON, used for snippets. */
+export declare const toPlainText: (value: unknown) => string;
+/**
+ * Walks a dotted path, transparently flattening arrays so repeatable components
+ * yield every one of their values.
+ */
+export declare const collectValues: (node: unknown, parts: string[]) => string[];
+export declare const getValuesAtPath: (entry: unknown, path: string) => string[];
+/** Extracts a short excerpt centred on the match, for highlighting in the UI. */
+export declare const buildSnippet: (value: unknown, query: string) => string;
+export declare const humanizeFieldPath: (path: string) => string;
+//# sourceMappingURL=text.d.ts.map

package/dist/server/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../server/utils/text.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,KAAG,MAI5C,CAAC;AA+CF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IAoB/D,CAAC;AAgCF,2FAA2F;AAC3F,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAU5C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,OAAO,MAAM,EAAE,KAAG,MAAM,EAgBpE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,MAAM,MAAM,KAAG,MAAM,EAC9B,CAAC;AAExC,iFAAiF;AACjF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,EAAE,OAAO,MAAM,KAAG,MAgB5D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MASjC,CAAC"}

package/package.json

@@ -1,6 +1,82 @@
 {
   "name": "@vicacha-devs/strapi-plugin-global-search",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.3",
+  "description": "Spotlight-style global search across every collection type and single type in the Strapi v5 admin panel. Zero configuration.",
+  "keywords": [
+    "admin",
+    "command-palette",
+    "global-search",
+    "search",
+    "spotlight",
+    "strapi",
+    "strapi-plugin",
+    "strapi-v5"
+  ],
+  "homepage": "https://github.com/Vicacha-Devs/strapi-v5-extensions/tree/main/packages/strapi-plugin-global-search#readme",
+  "bugs": {
+    "url": "https://github.com/Vicacha-Devs/strapi-v5-extensions/issues"
+  },
+  "license": "MIT",
+  "author": "Vicacha Devs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vicacha-Devs/strapi-v5-extensions.git",
+    "directory": "packages/strapi-plugin-global-search"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    "./strapi-admin": {
+      "types": "./dist/admin/index.d.ts",
+      "import": "./dist/admin/index.js",
+      "default": "./dist/admin/index.js"
+    },
+    "./strapi-server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "esbuild": "^0.25.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "@vicacha-devs/plugin-shared": "1.0.0"
+  },
+  "peerDependencies": {
+    "@strapi/design-system": "^2.0.0",
+    "@strapi/icons": "^2.0.0",
+    "@strapi/strapi": "^5.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "react-router-dom": "^6.0.0",
+    "styled-components": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=20.16.0",
+    "pnpm": ">=10.0.0"
+  },
+  "strapi": {
+    "name": "global-search",
+    "kind": "plugin",
+    "displayName": "Global Search",
+    "description": "Search every content type from one place, with a Cmd+K palette.",
+    "icon": "search"
+  },
+  "scripts": {
+    "build": "node scripts/build.ts",
+    "test": "tsx tests/services.test.ts",
+    "test:ts": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.server.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.server.json --noEmit"
+  }
 }