@xemahq/contracts 0.1.0

package/dist/search/lib/route-template.d.ts

@@ -0,0 +1,31 @@
+export declare enum SearchRouteTemplateVariable {
+    OrgId = "orgId",
+    ProjectId = "projectId",
+    DocType = "docType",
+    ObjectKind = "objectKind",
+    SourceId = "sourceId",
+    Slug = "slug",
+    Title = "title",
+    ContainerSlug = "containerSlug"
+}
+export declare enum SearchRouteVariableSource {
+    Scope = "scope",
+    Identity = "identity",
+    Projected = "projected"
+}
+export declare const SEARCH_ROUTE_TEMPLATE_VARIABLE_SOURCE: Readonly<Record<SearchRouteTemplateVariable, SearchRouteVariableSource>>;
+export declare const SEARCH_ROUTE_PROJECTED_VARIABLES: ReadonlySet<SearchRouteTemplateVariable>;
+export declare function isProjectedSearchRouteVariable(variable: SearchRouteTemplateVariable): boolean;
+export declare const SEARCH_ROUTE_TEMPLATE_VARIABLES: ReadonlySet<string>;
+export declare const SEARCH_ROUTE_TEMPLATE_PLACEHOLDER_PATTERN: RegExp;
+export declare class SearchRouteTemplateError extends Error {
+    readonly code = "SEARCH_ROUTE_TEMPLATE_INVALID";
+    readonly template: string;
+    readonly reason: string;
+    constructor(template: string, reason: string);
+}
+export declare function assertValidSearchRouteTemplate(template: string): void;
+export declare function assertSearchRouteTemplateSatisfiable(template: string, provided: readonly SearchRouteTemplateVariable[]): void;
+export declare function extractSearchRouteTemplateVariables(template: string): SearchRouteTemplateVariable[];
+export declare function expandSearchRouteTemplate(template: string, values: Readonly<Partial<Record<SearchRouteTemplateVariable, string>>>): string;
+//# sourceMappingURL=route-template.d.ts.map

package/dist/search/lib/route-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-template.d.ts","sourceRoot":"","sources":["../../../src/search/lib/route-template.ts"],"names":[],"mappings":"AAqDA,oBAAY,2BAA2B;IAErC,KAAK,UAAU;IAEf,SAAS,cAAc;IAEvB,OAAO,YAAY;IAEnB,UAAU,eAAe;IAEzB,QAAQ,aAAa;IAOrB,IAAI,SAAS;IAEb,KAAK,UAAU;IAUf,aAAa,kBAAkB;CAChC;AAOD,oBAAY,yBAAyB;IAEnC,KAAK,UAAU;IAEf,QAAQ,aAAa;IAOrB,SAAS,cAAc;CACxB;AAMD,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAC1D,MAAM,CAAC,2BAA2B,EAAE,yBAAyB,CAAC,CAW9D,CAAC;AAQH,eAAO,MAAM,gCAAgC,EAAE,WAAW,CAAC,2BAA2B,CAWnF,CAAC;AAGJ,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,2BAA2B,GACpC,OAAO,CAET;AAMD,eAAO,MAAM,+BAA+B,EAAE,WAAW,CAAC,MAAM,CAE/D,CAAC;AAUF,eAAO,MAAM,yCAAyC,QAAyB,CAAC;AAMhF,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,IAAI,mCAAmC;IACvD,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEZ,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAMpD;AAmBD,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAwCrE;AAoBD,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,2BAA2B,EAAE,GAC/C,IAAI,CAqDN;AA2BD,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,MAAM,GACf,2BAA2B,EAAE,CAG/B;AAcD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC,CAAC,GACrE,MAAM,CAiBR"}

package/dist/search/lib/route-template.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchRouteTemplateError = exports.SEARCH_ROUTE_TEMPLATE_PLACEHOLDER_PATTERN = exports.SEARCH_ROUTE_TEMPLATE_VARIABLES = exports.SEARCH_ROUTE_PROJECTED_VARIABLES = exports.SEARCH_ROUTE_TEMPLATE_VARIABLE_SOURCE = exports.SearchRouteVariableSource = exports.SearchRouteTemplateVariable = void 0;
+exports.isProjectedSearchRouteVariable = isProjectedSearchRouteVariable;
+exports.assertValidSearchRouteTemplate = assertValidSearchRouteTemplate;
+exports.assertSearchRouteTemplateSatisfiable = assertSearchRouteTemplateSatisfiable;
+exports.extractSearchRouteTemplateVariables = extractSearchRouteTemplateVariables;
+exports.expandSearchRouteTemplate = expandSearchRouteTemplate;
+var SearchRouteTemplateVariable;
+(function (SearchRouteTemplateVariable) {
+    SearchRouteTemplateVariable["OrgId"] = "orgId";
+    SearchRouteTemplateVariable["ProjectId"] = "projectId";
+    SearchRouteTemplateVariable["DocType"] = "docType";
+    SearchRouteTemplateVariable["ObjectKind"] = "objectKind";
+    SearchRouteTemplateVariable["SourceId"] = "sourceId";
+    SearchRouteTemplateVariable["Slug"] = "slug";
+    SearchRouteTemplateVariable["Title"] = "title";
+    SearchRouteTemplateVariable["ContainerSlug"] = "containerSlug";
+})(SearchRouteTemplateVariable || (exports.SearchRouteTemplateVariable = SearchRouteTemplateVariable = {}));
+var SearchRouteVariableSource;
+(function (SearchRouteVariableSource) {
+    SearchRouteVariableSource["Scope"] = "scope";
+    SearchRouteVariableSource["Identity"] = "identity";
+    SearchRouteVariableSource["Projected"] = "projected";
+})(SearchRouteVariableSource || (exports.SearchRouteVariableSource = SearchRouteVariableSource = {}));
+exports.SEARCH_ROUTE_TEMPLATE_VARIABLE_SOURCE = Object.freeze({
+    [SearchRouteTemplateVariable.OrgId]: SearchRouteVariableSource.Scope,
+    [SearchRouteTemplateVariable.ProjectId]: SearchRouteVariableSource.Scope,
+    [SearchRouteTemplateVariable.DocType]: SearchRouteVariableSource.Identity,
+    [SearchRouteTemplateVariable.ObjectKind]: SearchRouteVariableSource.Identity,
+    [SearchRouteTemplateVariable.SourceId]: SearchRouteVariableSource.Identity,
+    [SearchRouteTemplateVariable.Title]: SearchRouteVariableSource.Identity,
+    [SearchRouteTemplateVariable.Slug]: SearchRouteVariableSource.Projected,
+    [SearchRouteTemplateVariable.ContainerSlug]: SearchRouteVariableSource.Projected,
+});
+exports.SEARCH_ROUTE_PROJECTED_VARIABLES = new Set(Object.values(SearchRouteTemplateVariable).filter((variable) => exports.SEARCH_ROUTE_TEMPLATE_VARIABLE_SOURCE[variable] ===
+    SearchRouteVariableSource.Projected));
+function isProjectedSearchRouteVariable(variable) {
+    return exports.SEARCH_ROUTE_PROJECTED_VARIABLES.has(variable);
+}
+exports.SEARCH_ROUTE_TEMPLATE_VARIABLES = new Set(Object.values(SearchRouteTemplateVariable));
+exports.SEARCH_ROUTE_TEMPLATE_PLACEHOLDER_PATTERN = /\{([A-Za-z0-9_]+)\}/g;
+class SearchRouteTemplateError extends Error {
+    code = 'SEARCH_ROUTE_TEMPLATE_INVALID';
+    template;
+    reason;
+    constructor(template, reason) {
+        super(`Invalid search route template "${template}": ${reason}`);
+        this.name = 'SearchRouteTemplateError';
+        this.template = template;
+        this.reason = reason;
+    }
+}
+exports.SearchRouteTemplateError = SearchRouteTemplateError;
+function allowedVariableList() {
+    return [...exports.SEARCH_ROUTE_TEMPLATE_VARIABLES].sort().join(', ');
+}
+function assertValidSearchRouteTemplate(template) {
+    if (template.length === 0) {
+        throw new SearchRouteTemplateError(template, 'must be non-empty');
+    }
+    if (!template.startsWith('/')) {
+        throw new SearchRouteTemplateError(template, 'must be a site-relative path starting with "/"');
+    }
+    if (/\s/.test(template)) {
+        throw new SearchRouteTemplateError(template, 'must not contain whitespace');
+    }
+    if (template.includes('//')) {
+        throw new SearchRouteTemplateError(template, 'must not contain an empty path segment ("//")');
+    }
+    const residue = template.replace(exports.SEARCH_ROUTE_TEMPLATE_PLACEHOLDER_PATTERN, '');
+    if (residue.includes('{') || residue.includes('}')) {
+        throw new SearchRouteTemplateError(template, 'contains a malformed placeholder — every placeholder must be "{name}" with name matching [A-Za-z0-9_]+');
+    }
+    for (const name of readTemplateVariableNames(template)) {
+        if (!exports.SEARCH_ROUTE_TEMPLATE_VARIABLES.has(name)) {
+            throw new SearchRouteTemplateError(template, `unknown placeholder "{${name}}" — allowed placeholders are: ${allowedVariableList()}`);
+        }
+    }
+}
+function assertSearchRouteTemplateSatisfiable(template, provided) {
+    assertValidSearchRouteTemplate(template);
+    const declared = new Set();
+    for (const variable of provided) {
+        if (!exports.SEARCH_ROUTE_TEMPLATE_VARIABLES.has(variable)) {
+            throw new SearchRouteTemplateError(template, `declared route param "${String(variable)}" is not a search route variable — ` +
+                `allowed variables are: ${allowedVariableList()}`);
+        }
+        if (!isProjectedSearchRouteVariable(variable)) {
+            throw new SearchRouteTemplateError(template, `route param "${variable}" must not be declared — it is supplied by the platform ` +
+                `(source "${exports.SEARCH_ROUTE_TEMPLATE_VARIABLE_SOURCE[variable]}"), not by the producer. ` +
+                `Only ${projectedVariableList()} may be declared.`);
+        }
+        if (declared.has(variable)) {
+            throw new SearchRouteTemplateError(template, `route param "${variable}" is declared more than once`);
+        }
+        declared.add(variable);
+    }
+    const referenced = new Set(readTemplateVariableNames(template));
+    for (const variable of referenced) {
+        if (isProjectedSearchRouteVariable(variable) && !declared.has(variable)) {
+            throw new SearchRouteTemplateError(template, `placeholder "{${variable}}" is projected by the owning source, but this result-type ` +
+                `does not declare it in renderHints.routeParams — the template could never expand. ` +
+                `Either declare it (and stamp it on IndexableDocument.routeParams) or drop it from the template.`);
+        }
+    }
+    for (const variable of declared) {
+        if (!referenced.has(variable)) {
+            throw new SearchRouteTemplateError(template, `route param "${variable}" is declared but never referenced by the template — ` +
+                'remove the dead declaration');
+        }
+    }
+}
+function projectedVariableList() {
+    return [...exports.SEARCH_ROUTE_PROJECTED_VARIABLES].sort().join(', ');
+}
+function readTemplateVariableNames(template) {
+    const seen = new Set();
+    for (const match of template.matchAll(exports.SEARCH_ROUTE_TEMPLATE_PLACEHOLDER_PATTERN)) {
+        const name = match[1];
+        if (name !== undefined) {
+            seen.add(name);
+        }
+    }
+    return [...seen];
+}
+function extractSearchRouteTemplateVariables(template) {
+    assertValidSearchRouteTemplate(template);
+    return readTemplateVariableNames(template);
+}
+function expandSearchRouteTemplate(template, values) {
+    assertValidSearchRouteTemplate(template);
+    return template.replace(exports.SEARCH_ROUTE_TEMPLATE_PLACEHOLDER_PATTERN, (_match, rawName) => {
+        const name = rawName;
+        const value = values[name];
+        if (value === undefined || value.length === 0) {
+            throw new SearchRouteTemplateError(template, `no value supplied for placeholder "{${name}}" — the template cannot be expanded in this context`);
+        }
+        return encodeURIComponent(value);
+    });
+}
+//# sourceMappingURL=route-template.js.map

package/dist/search/lib/route-template.js.map

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

package/dist/search/lib/search-contribution.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { type CapabilityRef } from '../../capability';
+import { XemaObjectKind } from '../../object';
+import { ResourceVisibilityPattern } from '../../resource';
+import { SearchRouteTemplateVariable } from './route-template';
+export interface SearchTypeRenderHints {
+    readonly label: string;
+    readonly icon?: string;
+    readonly routeTemplate?: string;
+    readonly routeParams?: readonly SearchRouteTemplateVariable[];
+}
+export declare const SearchTypeRenderHintsSchema: z.ZodType<SearchTypeRenderHints>;
+export interface SearchTypeAuthzMapping {
+    readonly resourceType: string;
+    readonly defaultVisibility: ResourceVisibilityPattern;
+}
+export declare const SearchTypeAuthzMappingSchema: z.ZodType<SearchTypeAuthzMapping>;
+export interface SearchTypeContributionManifest {
+    readonly objectKind?: XemaObjectKind;
+    readonly docType?: string;
+    readonly renderHints: SearchTypeRenderHints;
+    readonly searchableFields: readonly string[];
+    readonly embeddingEligibleDefault: boolean;
+    readonly authz: SearchTypeAuthzMapping;
+    readonly searchReplayCapabilityRef?: CapabilityRef;
+}
+export declare const SearchTypeContributionManifestSchema: z.ZodType<SearchTypeContributionManifest>;
+export declare function searchTypeNaturalKey(objectKind?: XemaObjectKind, docType?: string): string;
+//# sourceMappingURL=search-contribution.d.ts.map

package/dist/search/lib/search-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-contribution.d.ts","sourceRoot":"","sources":["../../../src/search/lib/search-contribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAwB,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,yBAAyB,EAE1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGL,2BAA2B,EAE5B,MAAM,kBAAkB,CAAC;AA6B1B,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAevB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAiBhC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC/D;AASD,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CA0CjC,CAAC;AAWzC,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;CACvD;AAED,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAIvE,CAAC;AAiBL,MAAM,WAAW,8BAA8B;IAiB7C,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;IAMrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAK5C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAM7C,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAE3C,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IAOvC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,aAAa,CAAC;CACpD;AASD,eAAO,MAAM,oCAAoC,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAsB9B,CAAC;AAY9D,wBAAgB,oBAAoB,CAClC,UAAU,CAAC,EAAE,cAAc,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CASR"}

package/dist/search/lib/search-contribution.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchTypeContributionManifestSchema = exports.SearchTypeAuthzMappingSchema = exports.SearchTypeRenderHintsSchema = void 0;
+exports.searchTypeNaturalKey = searchTypeNaturalKey;
+const zod_1 = require("zod");
+const capability_1 = require("../../capability");
+const object_1 = require("../../object");
+const resource_1 = require("../../resource");
+const route_template_1 = require("./route-template");
+const SEARCH_TYPE_STRING_MAX = 200;
+const SEARCH_TYPE_ROUTE_TEMPLATE_MAX = 500;
+const SEARCH_TYPE_FIELDS_MAX = 100;
+const SEARCH_TYPE_ROUTE_PARAMS_MAX = route_template_1.SEARCH_ROUTE_PROJECTED_VARIABLES.size;
+exports.SearchTypeRenderHintsSchema = zod_1.z
+    .object({
+    label: zod_1.z.string().min(1).max(SEARCH_TYPE_STRING_MAX),
+    icon: zod_1.z.string().min(1).max(SEARCH_TYPE_STRING_MAX).optional(),
+    routeTemplate: zod_1.z
+        .string()
+        .min(1)
+        .max(SEARCH_TYPE_ROUTE_TEMPLATE_MAX)
+        .optional(),
+    routeParams: zod_1.z
+        .array(zod_1.z.nativeEnum(route_template_1.SearchRouteTemplateVariable))
+        .max(SEARCH_TYPE_ROUTE_PARAMS_MAX)
+        .optional(),
+})
+    .superRefine((value, ctx) => {
+    if (value.routeTemplate === undefined) {
+        if (value.routeParams !== undefined) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ['routeParams'],
+                message: 'routeParams declares route variables but no routeTemplate uses them — ' +
+                    'a supply declaration without a template is dead weight.',
+            });
+        }
+        return;
+    }
+    try {
+        (0, route_template_1.assertSearchRouteTemplateSatisfiable)(value.routeTemplate, value.routeParams ?? []);
+    }
+    catch (error) {
+        if (!(error instanceof route_template_1.SearchRouteTemplateError)) {
+            throw error;
+        }
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['routeTemplate'],
+            message: error.reason,
+        });
+    }
+});
+exports.SearchTypeAuthzMappingSchema = zod_1.z.object({
+    resourceType: zod_1.z.string().min(1).max(SEARCH_TYPE_STRING_MAX),
+    defaultVisibility: resource_1.ResourceVisibilityPatternSchema,
+});
+exports.SearchTypeContributionManifestSchema = zod_1.z
+    .object({
+    objectKind: object_1.XemaObjectKindSchema.optional(),
+    docType: zod_1.z.string().min(1).max(SEARCH_TYPE_STRING_MAX).optional(),
+    renderHints: exports.SearchTypeRenderHintsSchema,
+    searchableFields: zod_1.z
+        .array(zod_1.z.string().min(1).max(SEARCH_TYPE_STRING_MAX))
+        .min(1)
+        .max(SEARCH_TYPE_FIELDS_MAX),
+    embeddingEligibleDefault: zod_1.z.boolean(),
+    authz: exports.SearchTypeAuthzMappingSchema,
+    searchReplayCapabilityRef: capability_1.CapabilityRefSchema.optional(),
+})
+    .refine((m) => m.objectKind !== undefined || m.docType !== undefined, 'a search-type contribution must declare objectKind, docType, or both — ' +
+    'the natural key is (objectKind, docType) and cannot be empty');
+function searchTypeNaturalKey(objectKind, docType) {
+    if (objectKind === undefined && docType === undefined) {
+        throw new Error('searchTypeNaturalKey: neither objectKind nor docType was supplied — ' +
+            'a result-type must be addressable by at least one.');
+    }
+    if (objectKind === undefined)
+        return String(docType);
+    return docType ? `${objectKind}/${docType}` : String(objectKind);
+}
+//# sourceMappingURL=search-contribution.js.map

package/dist/search/lib/search-contribution.js.map

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

package/dist/search-source/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/indexable-document';
+export * from './lib/search-ref';
+export * from './lib/search-index-event';
+export * from './lib/search-source-descriptor';
+export * from './lib/search-replay';
+//# sourceMappingURL=index.d.ts.map

package/dist/search-source/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search-source/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC"}

package/dist/search-source/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/indexable-document"), exports);
+__exportStar(require("./lib/search-ref"), exports);
+__exportStar(require("./lib/search-index-event"), exports);
+__exportStar(require("./lib/search-source-descriptor"), exports);
+__exportStar(require("./lib/search-replay"), exports);
+//# sourceMappingURL=index.js.map

package/dist/search-source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search-source/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,mDAAiC;AACjC,2DAAyC;AACzC,iEAA+C;AAC/C,sDAAoC"}

package/dist/search-source/lib/indexable-document.d.ts

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { type XemaObjectKind, type XemaObjectRef } from '../../object';
+import { type ResourceVisibilityPattern } from '../../resource';
+import { SearchRouteTemplateVariable } from '../../search';
+import { type DataClassification, type SpaceRef } from '../../space';
+import { type SubjectRef } from '../../subject';
+export interface IndexableDocument {
+    readonly ref: XemaObjectRef;
+    readonly docType: string;
+    readonly kind?: XemaObjectKind;
+    readonly scope: SpaceRef;
+    readonly owner: SubjectRef;
+    readonly classification?: DataClassification;
+    readonly resourceType: string;
+    readonly visibility: ResourceVisibilityPattern;
+    readonly title?: string;
+    readonly summary?: string;
+    readonly content?: string;
+    readonly code?: string;
+    readonly tags?: readonly string[];
+    readonly status?: string;
+    readonly phase?: string;
+    readonly priority?: string;
+    readonly createdBy?: string;
+    readonly createdAt?: string;
+    readonly updatedAt?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly routeParams?: Readonly<Partial<Record<SearchRouteTemplateVariable, string>>>;
+    readonly embeddingEligible?: boolean;
+}
+export declare const SearchRouteParamsSchema: z.ZodObject<{
+    orgId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    docType: z.ZodOptional<z.ZodString>;
+    objectKind: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    containerSlug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const IndexableDocumentSchema: z.ZodObject<{
+    ref: z.ZodString & z.ZodType<`xema://${string}`, string, z.core.$ZodTypeInternals<`xema://${string}`, string>>;
+    docType: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<typeof XemaObjectKind>>;
+    scope: z.ZodObject<{
+        tier: z.ZodEnum<typeof import("../../space").SpaceKind>;
+        orgId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+        appId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        biomeId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        classification: z.ZodOptional<z.ZodEnum<typeof DataClassification>>;
+    }, z.core.$strip>;
+    owner: z.ZodType<SubjectRef, unknown, z.core.$ZodTypeInternals<SubjectRef, unknown>>;
+    classification: z.ZodOptional<z.ZodEnum<typeof DataClassification>>;
+    resourceType: z.ZodString;
+    visibility: z.ZodEnum<typeof ResourceVisibilityPattern>;
+    title: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodString>;
+    createdBy: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    routeParams: z.ZodOptional<z.ZodObject<{
+        orgId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+        docType: z.ZodOptional<z.ZodString>;
+        objectKind: z.ZodOptional<z.ZodString>;
+        sourceId: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        containerSlug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    embeddingEligible: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+//# sourceMappingURL=indexable-document.d.ts.map

package/dist/search-source/lib/indexable-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexable-document.d.ts","sourceRoot":"","sources":["../../../src/search-source/lib/indexable-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAiClE,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAK5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAKzB,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAE/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAE3B,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAE7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAgBtD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAC7B,OAAO,CAAC,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC,CACrD,CAAC;IAaF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAYD,eAAO,MAAM,uBAAuB;;;;;;;;;kBASzB,CAAC;AAMZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyBzB,CAAC"}

package/dist/search-source/lib/indexable-document.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexableDocumentSchema = exports.SearchRouteParamsSchema = void 0;
+const zod_1 = require("zod");
+const object_1 = require("../../object");
+const resource_1 = require("../../resource");
+const search_1 = require("../../search");
+const space_1 = require("../../space");
+const subject_1 = require("../../subject");
+const SEARCH_ROUTE_PARAM_VALUE_MAX = 200;
+exports.SearchRouteParamsSchema = zod_1.z
+    .object(Object.fromEntries([...search_1.SEARCH_ROUTE_PROJECTED_VARIABLES].map((variable) => [
+    variable,
+    zod_1.z.string().min(1).max(SEARCH_ROUTE_PARAM_VALUE_MAX).optional(),
+])))
+    .strict();
+exports.IndexableDocumentSchema = zod_1.z
+    .object({
+    ref: object_1.XemaObjectRefSchema,
+    docType: zod_1.z.string().min(1),
+    kind: object_1.XemaObjectKindSchema.optional(),
+    scope: space_1.SpaceRefSchema,
+    owner: subject_1.SubjectRefSchema,
+    classification: space_1.DataClassificationSchema.optional(),
+    resourceType: zod_1.z.string().min(1),
+    visibility: resource_1.ResourceVisibilityPatternSchema,
+    title: zod_1.z.string().optional(),
+    summary: zod_1.z.string().optional(),
+    content: zod_1.z.string().optional(),
+    code: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    status: zod_1.z.string().optional(),
+    phase: zod_1.z.string().optional(),
+    priority: zod_1.z.string().optional(),
+    createdBy: zod_1.z.string().optional(),
+    createdAt: zod_1.z.string().optional(),
+    updatedAt: zod_1.z.string().optional(),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    routeParams: exports.SearchRouteParamsSchema.optional(),
+    embeddingEligible: zod_1.z.boolean().optional(),
+})
+    .strict();
+//# sourceMappingURL=indexable-document.js.map

package/dist/search-source/lib/indexable-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexable-document.js","sourceRoot":"","sources":["../../../src/search-source/lib/indexable-document.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,yCAKsB;AACtB,6CAGwB;AACxB,yCAGsB;AACtB,uCAKqB;AACrB,2CAAkE;AA2GlE,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAS5B,QAAA,uBAAuB,GAAG,OAAC;KACrC,MAAM,CACL,MAAM,CAAC,WAAW,CAChB,CAAC,GAAG,yCAAgC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;IACtD,QAAQ;IACR,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CACgE,CACrE;KACA,MAAM,EAAE,CAAC;AAMC,QAAA,uBAAuB,GAAG,OAAC;KACrC,MAAM,CAAC;IACN,GAAG,EAAE,4BAAmB;IACxB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,sBAAc;IACrB,KAAK,EAAE,0BAAgB;IACvB,cAAc,EAAE,gCAAwB,CAAC,QAAQ,EAAE;IACnD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,UAAU,EAAE,0CAA+B;IAC3C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,WAAW,EAAE,+BAAuB,CAAC,QAAQ,EAAE;IAC/C,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/search-source/lib/search-index-event.d.ts

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { type SpaceRef } from '../../space';
+import { type IndexableDocument } from './indexable-document';
+export declare enum SearchIndexOp {
+    Upsert = "upsert",
+    Delete = "delete"
+}
+export declare const SEARCH_INDEX_UPSERT_EVENT_TYPE: "search.index.upsert";
+export declare const SEARCH_INDEX_DELETE_EVENT_TYPE: "search.index.delete";
+export interface SearchIndexUpsert {
+    readonly op: SearchIndexOp.Upsert;
+    readonly document: IndexableDocument;
+}
+export interface SearchIndexDelete {
+    readonly op: SearchIndexOp.Delete;
+    readonly scope: SpaceRef;
+    readonly docType: string;
+    readonly sourceId: string;
+}
+export type SearchIndexChange = SearchIndexUpsert | SearchIndexDelete;
+export declare const SearchIndexUpsertSchema: z.ZodObject<{
+    op: z.ZodLiteral<SearchIndexOp.Upsert>;
+    document: z.ZodObject<{
+        ref: z.ZodString & z.ZodType<`xema://${string}`, string, z.core.$ZodTypeInternals<`xema://${string}`, string>>;
+        docType: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<typeof import("../../object").XemaObjectKind>>;
+        scope: z.ZodObject<{
+            tier: z.ZodEnum<typeof import("../../space").SpaceKind>;
+            orgId: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            appId: z.ZodOptional<z.ZodString>;
+            sessionId: z.ZodOptional<z.ZodString>;
+            biomeId: z.ZodOptional<z.ZodString>;
+            userId: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            classification: z.ZodOptional<z.ZodEnum<typeof import("../../space").DataClassification>>;
+        }, z.core.$strip>;
+        owner: z.ZodType<import("../../subject").SubjectRef, unknown, z.core.$ZodTypeInternals<import("../../subject").SubjectRef, unknown>>;
+        classification: z.ZodOptional<z.ZodEnum<typeof import("../../space").DataClassification>>;
+        resourceType: z.ZodString;
+        visibility: z.ZodEnum<typeof import("../../resource").ResourceVisibilityPattern>;
+        title: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        code: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        status: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodString>;
+        priority: z.ZodOptional<z.ZodString>;
+        createdBy: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        routeParams: z.ZodOptional<z.ZodObject<{
+            orgId: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            docType: z.ZodOptional<z.ZodString>;
+            objectKind: z.ZodOptional<z.ZodString>;
+            sourceId: z.ZodOptional<z.ZodString>;
+            slug: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            containerSlug: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        embeddingEligible: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const SearchIndexDeleteSchema: z.ZodObject<{
+    op: z.ZodLiteral<SearchIndexOp.Delete>;
+    scope: z.ZodObject<{
+        tier: z.ZodEnum<typeof import("../../space").SpaceKind>;
+        orgId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+        appId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        biomeId: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        classification: z.ZodOptional<z.ZodEnum<typeof import("../../space").DataClassification>>;
+    }, z.core.$strip>;
+    docType: z.ZodString;
+    sourceId: z.ZodString;
+}, z.core.$strict>;
+//# sourceMappingURL=search-index-event.d.ts.map

package/dist/search-source/lib/search-index-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index-event.d.ts","sourceRoot":"","sources":["../../../src/search-source/lib/search-index-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAK9B,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAQD,eAAO,MAAM,8BAA8B,EAAG,qBAA8B,CAAC;AAC7E,eAAO,MAAM,8BAA8B,EAAG,qBAA8B,CAAC;AAG7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AASD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKzB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;kBAOzB,CAAC"}

package/dist/search-source/lib/search-index-event.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchIndexDeleteSchema = exports.SearchIndexUpsertSchema = exports.SEARCH_INDEX_DELETE_EVENT_TYPE = exports.SEARCH_INDEX_UPSERT_EVENT_TYPE = exports.SearchIndexOp = void 0;
+const zod_1 = require("zod");
+const space_1 = require("../../space");
+const indexable_document_1 = require("./indexable-document");
+var SearchIndexOp;
+(function (SearchIndexOp) {
+    SearchIndexOp["Upsert"] = "upsert";
+    SearchIndexOp["Delete"] = "delete";
+})(SearchIndexOp || (exports.SearchIndexOp = SearchIndexOp = {}));
+exports.SEARCH_INDEX_UPSERT_EVENT_TYPE = 'search.index.upsert';
+exports.SEARCH_INDEX_DELETE_EVENT_TYPE = 'search.index.delete';
+exports.SearchIndexUpsertSchema = zod_1.z
+    .object({
+    op: zod_1.z.literal(SearchIndexOp.Upsert),
+    document: indexable_document_1.IndexableDocumentSchema,
+})
+    .strict();
+exports.SearchIndexDeleteSchema = zod_1.z
+    .object({
+    op: zod_1.z.literal(SearchIndexOp.Delete),
+    scope: space_1.SpaceRefSchema,
+    docType: zod_1.z.string().min(1),
+    sourceId: zod_1.z.string().min(1),
+})
+    .strict();
+//# sourceMappingURL=search-index-event.js.map

package/dist/search-source/lib/search-index-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index-event.js","sourceRoot":"","sources":["../../../src/search-source/lib/search-index-event.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,uCAA4D;AAC5D,6DAG8B;AAK9B,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;AACnB,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAQY,QAAA,8BAA8B,GAAG,qBAA8B,CAAC;AAChE,QAAA,8BAA8B,GAAG,qBAA8B,CAAC;AAwBhE,QAAA,uBAAuB,GAAG,OAAC;KACrC,MAAM,CAAC;IACN,EAAE,EAAE,OAAC,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,4CAAuB;CAClC,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,uBAAuB,GAAG,OAAC;KACrC,MAAM,CAAC;IACN,EAAE,EAAE,OAAC,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,sBAAc;IACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/search-source/lib/search-ref.d.ts

@@ -0,0 +1,17 @@
+import { type XemaObjectRef } from '../../object';
+import { type SpaceRef } from '../../space';
+export declare class SearchRefParseError extends Error {
+    readonly code = "SEARCH_REF_INVALID";
+    readonly ref: string;
+    readonly reason: string;
+    constructor(ref: string, reason: string);
+}
+export interface SearchRefParts {
+    readonly scope: SpaceRef;
+    readonly docType: string;
+    readonly sourceId: string;
+}
+export declare function formatSearchRef(scope: SpaceRef, docType: string, sourceId: string): XemaObjectRef;
+export declare function parseSearchRef(ref: string): SearchRefParts;
+export declare function searchDocumentScope(orgId: string, projectId?: string): SpaceRef;
+//# sourceMappingURL=search-ref.d.ts.map

package/dist/search-source/lib/search-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-ref.d.ts","sourceRoot":"","sources":["../../../src/search-source/lib/search-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAmCrB,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,IAAI,wBAAwB;IAC5C,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEZ,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM/C;AAGD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA4BD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,aAAa,CAKf;AAQD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAyC1D;AAUD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CASV"}