@adaas/a-frame 0.0.23 → 0.1.2

package/dist/node/chunk-IYEDO7OQ.cjs

@@ -0,0 +1,276 @@
+'use strict';
+
+var chunkZM2RLVVH_cjs = require('./chunk-ZM2RLVVH.cjs');
+var chunkHAORARSB_cjs = require('./chunk-HAORARSB.cjs');
+var chunk64QCZG53_cjs = require('./chunk-64QCZG53.cjs');
+var aConcept = require('@adaas/a-concept');
+
+// src/lib/A-FrameDefinition/A-FrameDefinition.constants.ts
+var A_FrameDefinitionFeatures = {
+  Load: "_A_FRAME_DEFINITION_LOAD",
+  Save: "_A_FRAME_DEFINITION_SAVE",
+  Embed: "_A_FRAME_DEFINITION_EMBED",
+  Destroy: "_A_FRAME_DEFINITION_DESTROY"
+};
+
+// src/lib/A-FrameDefinition/A-FrameDefinition.entity.ts
+var A_FrameDefinition = class extends aConcept.A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //---------------------------------------- Primary properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  /**
+   * Definition Identifier from ASEID unique name 
+   */
+  get id() {
+    return this.aseid.id;
+  }
+  /**
+   * The type of the definition target (component, entity, container, fragment, or method)
+   */
+  get type() {
+    return this._type;
+  }
+  /**
+   * The name of the defined feature (e.g. "MyComponent", "myMethod", etc.)
+   */
+  get name() {
+    return this._name;
+  }
+  /**
+   * Description that explains the purpose of the defined feature, its inputs/outputs, or any other relevant information.
+   */
+  get description() {
+    return this._description;
+  }
+  get dependency() {
+    return new aConcept.A_Dependency(this._dependency);
+  }
+  /**
+   * The original source code string that implements the defined feature. This is the main content that gets embedded and indexed for search.
+   */
+  get source() {
+    return this._source;
+  }
+  /**
+   * The vector embedding representing the definition's source and metadata. This is populated after embedding and is used for similarity search in the index.
+   */
+  get vector() {
+    return this._vector;
+  }
+  /**
+   * Namespace to which this definition belongs. Used for scoping search and organizing definitions. If not specified, defaults to the global namespace.
+   */
+  get namespace() {
+    return this._namespace;
+  }
+  /**
+   * Additional metadata about the definition, stored as key-value pairs. This can include any relevant information that doesn't fit into the other properties but may be useful for search or organization.
+   */
+  get metadata() {
+    return this._metadata || {};
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //----------------------------------- Common State properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  /**
+   * A unique hash string computed from the definition's name, source, description, and metadata. This is used to identify identical definitions and avoid duplicates in the index.
+   */
+  get hash() {
+    return this._hash;
+  }
+  /**
+   * The timestamp (in milliseconds since epoch) when the definition was embedded. This is used for tracking the freshness of the embedding and can be useful for re-embedding stale definitions.
+   */
+  get date() {
+    return this._date;
+  }
+  /**
+   * The name of the embedding model used to produce the vector. This is important for understanding the characteristics of the embedding and for debugging purposes.
+   */
+  get model() {
+    return this._model;
+  }
+  /**
+   * The model requested for embedding at init time. Defaults to `A_FRAME_MODELS.ANTARES`
+   * if not explicitly overridden. Sent to the server in the embed request.
+   */
+  get requestedModel() {
+    return this._requestedModel;
+  }
+  /**
+   * ID of the server credential (API key) used during embedding. This is useful for auditing and debugging embedding operations, especially when multiple credentials are in use.
+   */
+  get credentialId() {
+    return this._credentialId;
+  }
+  /**
+   * Version of @adaas/a-frame that produced this record. This helps track compatibility and understand which version of the library was used to create the definition.
+   */
+  get aFrameVersion() {
+    return this._aFrameVersion;
+  }
+  /**
+   * Version of a-frame-server that produced the vector. This is useful for debugging embedding issues and ensuring compatibility between the library and the embed server.
+   */
+  get aFrameServerVersion() {
+    return this._aFrameServerVersion;
+  }
+  /**
+   * Structural metadata extracted server-side when the definition was embedded.
+   * Includes discovered methods, @A_Inject dependencies, and @A_Feature.Extend names.
+   */
+  get aFrameMeta() {
+    return this._aFrameMeta;
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //--------------------------------------- Computed properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  get isEmbed() {
+    return this._vector !== void 0;
+  }
+  /**
+   * Saves the definition to storage. The actual implementation of saving is handled by the A_FrameDefinitionFeatures.Save feature, which can be implemented by the environment (e.g. browser, Node.js) to persist the definition in a database, file system, or other storage mechanism.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  save(scope) {
+    return this.call(A_FrameDefinitionFeatures.Save, scope);
+  }
+  /**
+   * Deletes the definition from storage. The actual implementation of deletion is handled by the A_FrameDefinitionFeatures.Destroy feature, which can be implemented by the environment to remove the definition from the database, file system, or other storage mechanism.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  destroy(scope) {
+    return this.call(A_FrameDefinitionFeatures.Destroy, scope);
+  }
+  /**
+   * Loads the definition from storage. The actual implementation of loading is handled by the A_FrameDefinitionFeatures.Load feature, which can be implemented by the environment to retrieve the definition from the database, file system, or other storage mechanism and populate the entity's properties accordingly.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  load(scope) {
+    return this.call(A_FrameDefinitionFeatures.Load, scope);
+  }
+  /**
+   * Updates the definition's properties. This can be used to modify the source code, description, metadata, or namespace of the definition. After updating, you may want to call `embed()` again to refresh the embedding based on the new content.
+   * 
+   * @param updates 
+   */
+  update(updates) {
+    if (updates.source) this._source = updates.source;
+    if (updates.description !== void 0) this._description = updates.description;
+    if (updates.metadata !== void 0) this._metadata = updates.metadata;
+    if (updates.namespace !== void 0) this._namespace = updates.namespace;
+  }
+  /**
+   * Generates the embedding for the definition's source and metadata. 
+   * 
+   * @param scope 
+   * @returns 
+   */
+  embed(scope) {
+    return this.call(A_FrameDefinitionFeatures.Embed, scope);
+  }
+  fromNew(newEntity) {
+    this._type = newEntity.type;
+    this.aseid = this.generateASEID({
+      id: aConcept.A_FormatterHelper.toKebabCase(newEntity.dependency + "-" + newEntity.name),
+      scope: "a-frame"
+    });
+    this._name = newEntity.name;
+    const hashSource = this._name + "//" + (newEntity.description || "") + "//" + (newEntity.metadata ? JSON.stringify(newEntity.metadata) : "") + "//" + newEntity.source + "//Namespace: " + newEntity.namespace.id;
+    this._hash = chunkZM2RLVVH_cjs.A_FrameHashHelper.fnv1a(hashSource);
+    this._source = newEntity.source;
+    this._description = newEntity.description;
+    this._namespace = newEntity.namespace;
+    this._metadata = newEntity.metadata;
+    this._dependency = newEntity.dependency;
+    this._requestedModel = newEntity.model ?? chunk64QCZG53_cjs.A_FRAME_MODELS.ANTARES;
+  }
+  fromJSON(serialized) {
+    this._name = serialized.name;
+    this._hash = serialized.hash;
+    this._source = serialized.source || "";
+    this._description = serialized.description;
+    this._metadata = serialized.metadata;
+    this._vector = serialized.embedding ? new chunkHAORARSB_cjs.A_FrameVector(serialized.embedding) : void 0;
+    this._date = serialized.date;
+    this._model = serialized.model;
+    this._credentialId = serialized.credentialId;
+    this._aFrameVersion = serialized.aFrameVersion;
+    this._aFrameServerVersion = serialized.aFrameServerVersion;
+    this._aFrameMeta = serialized.aFrameMeta;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      hash: this._hash,
+      name: this._name,
+      source: this._source,
+      description: this._description,
+      metadata: this._metadata,
+      namespace: this._namespace.aseid.toString(),
+      embedding: this._vector?.values,
+      date: this._date ?? (/* @__PURE__ */ new Date()).toISOString(),
+      model: this._model,
+      credentialId: this._credentialId,
+      aFrameVersion: this._aFrameVersion,
+      aFrameServerVersion: this._aFrameServerVersion,
+      aFrameMeta: this._aFrameMeta
+    };
+  }
+  // ─── Embedding hydration ──────────────────────────────────────────────────
+  /** Populate the vector from a pre-existing storage record */
+  // hydrateFromRecord(record: A_FrameDefinition_Record): void {
+  //     if (record.hash !== this._hash) {
+  //         throw new Error(
+  //             `A_FrameDefinition.hydrateFromRecord: hash mismatch for "${this._name}" ` +
+  //             `(expected ${this._hash}, got ${record.hash})`
+  //         );
+  //     }
+  //     this._vector = new A_FrameVector(record.embedding);
+  //     this._embeddedAt = record.embeddedAt;
+  //     this._model = record.model;
+  //     this._credentialId = record.credentialId;
+  //     this._aFrameVersion = record.aFrameVersion;
+  //     this._aFrameServerVersion = record.aFrameServerVersion;
+  // }
+  /** Populate the vector from a freshly-fetched embedding */
+  hydrateFromEmbedding(embedding, meta) {
+    this._vector = new chunkHAORARSB_cjs.A_FrameVector(embedding);
+    this._date = (/* @__PURE__ */ new Date()).toISOString();
+    if (meta) {
+      this._model = meta.model;
+      this._credentialId = meta.credentialId ?? void 0;
+      this._aFrameVersion = meta.aFrameVersion;
+      this._aFrameServerVersion = meta.aFrameServerVersion;
+      if (meta.aFrameMeta)
+        this._aFrameMeta = meta.aFrameMeta;
+    }
+  }
+  // ─── Embedding input ──────────────────────────────────────────────────────
+  /**
+   * Build the text string sent to the embedding model.
+   * Concatenates name + description + source so the resulting
+   * vector captures both intent and implementation.
+   */
+  toString() {
+    const parts = [];
+    parts.push(`// ${this._name}`);
+    if (this._description) parts.push(`// ${this._description}`);
+    parts.push(this._source);
+    return parts.join("\n");
+  }
+};
+
+exports.A_FrameDefinition = A_FrameDefinition;
+exports.A_FrameDefinitionFeatures = A_FrameDefinitionFeatures;
+//# sourceMappingURL=chunk-IYEDO7OQ.cjs.map
+//# sourceMappingURL=chunk-IYEDO7OQ.cjs.map

package/dist/node/chunk-IYEDO7OQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDefinition/A-FrameDefinition.constants.ts","../../src/lib/A-FrameDefinition/A-FrameDefinition.entity.ts"],"names":["A_Entity","A_Dependency","A_FormatterHelper","A_FrameHashHelper","A_FRAME_MODELS","A_FrameVector"],"mappings":"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","file":"chunk-IYEDO7OQ.cjs","sourcesContent":["\n\nexport const A_FrameDefinitionFeatures = {\n    Load: '_A_FRAME_DEFINITION_LOAD',\n    Save: '_A_FRAME_DEFINITION_SAVE',\n    Embed: '_A_FRAME_DEFINITION_EMBED',\n    Destroy: '_A_FRAME_DEFINITION_DESTROY',\n} as const;","import { A_Dependency, A_Entity, A_FormatterHelper, A_Scope } from \"@adaas/a-concept\";\nimport {\n    A_FrameDefinition_EmbeddingMeta,\n    A_FrameDefinition_Init,\n    A_FrameDefinition_Serialized,\n    DefinitionExtractedMeta,\n} from \"./A-FrameDefinition.types\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameNamespace } from \"../A-FrameNamespace\";\nimport { A_FrameHashHelper } from \"@adaas/a-frame/helpers/Hash.helper\";\nimport { A_FrameDefinitionFeatures } from \"./A-FrameDefinition.constants\";\nimport { A_FrameTargetType } from \"../A-Frame/A-Frame.types\";\nimport { A_FRAME_MODELS } from \"../A-FrameModels\";\n\nexport class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameDefinition_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    protected _name!: string;\n    protected _type!: A_FrameTargetType;\n    protected _source!: string;\n    protected _dependency!: string;\n    protected _description?: string;\n    protected _namespace!: A_FrameNamespace;\n    protected _metadata?: Record<string, any>;\n    protected _vector?: A_FrameVector;\n\n    /**\n     * Common properties for all definition types (component, entity, container, fragment, method\n     */\n    protected _hash!: string;\n    protected _date?: string;\n    protected _model!: string;\n    protected _requestedModel!: string;\n    protected _credentialId!: string;\n    protected _aFrameVersion!: string;\n    protected _aFrameServerVersion!: string;\n    protected _aFrameMeta?: DefinitionExtractedMeta;\n\n    //-----------------------------------------------------------------------------------------------------\n    //---------------------------------------- Primary properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    /**\n     * Definition Identifier from ASEID unique name \n     */\n    get id(): string {\n        return this.aseid.id;\n    }\n    /**\n     * The type of the definition target (component, entity, container, fragment, or method)\n     */\n    get type(): A_FrameTargetType {\n        return this._type;\n    }\n    /**\n     * The name of the defined feature (e.g. \"MyComponent\", \"myMethod\", etc.)\n     */\n    get name(): string {\n        return this._name;\n    }\n    /**\n     * Description that explains the purpose of the defined feature, its inputs/outputs, or any other relevant information.\n     */\n    get description(): string | undefined {\n        return this._description;\n    }\n\n    get dependency(): A_Dependency {\n        return new A_Dependency(this._dependency);\n    }\n    /**\n     * The original source code string that implements the defined feature. This is the main content that gets embedded and indexed for search.\n     */\n    get source(): string {\n        return this._source;\n    }\n    /**\n     * The vector embedding representing the definition's source and metadata. This is populated after embedding and is used for similarity search in the index.\n     */\n    get vector(): A_FrameVector | undefined {\n        return this._vector;\n    }\n    /**\n     * Namespace to which this definition belongs. Used for scoping search and organizing definitions. If not specified, defaults to the global namespace.\n     */\n    get namespace(): A_FrameNamespace {\n        return this._namespace;\n    }\n    /**\n     * Additional metadata about the definition, stored as key-value pairs. This can include any relevant information that doesn't fit into the other properties but may be useful for search or organization.\n     */\n    get metadata(): Record<string, any> {\n        return this._metadata || {};\n    }\n    //-----------------------------------------------------------------------------------------------------\n    //----------------------------------- Common State properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    /**\n     * A unique hash string computed from the definition's name, source, description, and metadata. This is used to identify identical definitions and avoid duplicates in the index.\n     */\n    get hash(): string {\n        return this._hash;\n    }\n    /**\n     * The timestamp (in milliseconds since epoch) when the definition was embedded. This is used for tracking the freshness of the embedding and can be useful for re-embedding stale definitions.\n     */\n    get date(): string | undefined {\n        return this._date;\n    }\n    /**\n     * The name of the embedding model used to produce the vector. This is important for understanding the characteristics of the embedding and for debugging purposes.\n     */\n    get model(): string {\n        return this._model;\n    }\n    /**\n     * The model requested for embedding at init time. Defaults to `A_FRAME_MODELS.ANTARES`\n     * if not explicitly overridden. Sent to the server in the embed request.\n     */\n    get requestedModel(): string {\n        return this._requestedModel;\n    }\n    /**\n     * ID of the server credential (API key) used during embedding. This is useful for auditing and debugging embedding operations, especially when multiple credentials are in use.\n     */\n    get credentialId(): string | undefined {\n        return this._credentialId;\n    }\n    /**\n     * Version of @adaas/a-frame that produced this record. This helps track compatibility and understand which version of the library was used to create the definition.\n     */\n    get aFrameVersion(): string | undefined {\n        return this._aFrameVersion;\n    }\n    /**\n     * Version of a-frame-server that produced the vector. This is useful for debugging embedding issues and ensuring compatibility between the library and the embed server.\n     */\n    get aFrameServerVersion(): string | undefined {\n        return this._aFrameServerVersion;\n    }\n    /**\n     * Structural metadata extracted server-side when the definition was embedded.\n     * Includes discovered methods, @A_Inject dependencies, and @A_Feature.Extend names.\n     */\n    get aFrameMeta(): DefinitionExtractedMeta | undefined {\n        return this._aFrameMeta;\n    }\n    //-----------------------------------------------------------------------------------------------------\n    //--------------------------------------- Computed properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    get isEmbed(): boolean {\n        return this._vector !== undefined;\n    }\n    /**\n     * Saves the definition to storage. The actual implementation of saving is handled by the A_FrameDefinitionFeatures.Save feature, which can be implemented by the environment (e.g. browser, Node.js) to persist the definition in a database, file system, or other storage mechanism.\n     * \n     * @param scope \n     * @returns \n     */\n    save(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameDefinitionFeatures.Save, scope);\n    }\n    /**\n     * Deletes the definition from storage. The actual implementation of deletion is handled by the A_FrameDefinitionFeatures.Destroy feature, which can be implemented by the environment to remove the definition from the database, file system, or other storage mechanism.\n     * \n     * @param scope \n     * @returns \n     */\n    destroy(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameDefinitionFeatures.Destroy, scope);\n    }\n    /**\n     * Loads the definition from storage. The actual implementation of loading is handled by the A_FrameDefinitionFeatures.Load feature, which can be implemented by the environment to retrieve the definition from the database, file system, or other storage mechanism and populate the entity's properties accordingly.\n     * \n     * @param scope \n     * @returns \n     */\n    load(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameDefinitionFeatures.Load, scope);\n    }\n    /**\n     * Updates the definition's properties. This can be used to modify the source code, description, metadata, or namespace of the definition. After updating, you may want to call `embed()` again to refresh the embedding based on the new content.\n     * \n     * @param updates \n     */\n    update(updates: Partial<Pick<A_FrameDefinition, 'source' | 'description' | 'metadata' | 'namespace'>>): void {\n        if (updates.source) this._source = updates.source;\n        if (updates.description !== undefined) this._description = updates.description;\n        if (updates.metadata !== undefined) this._metadata = updates.metadata;\n        if (updates.namespace !== undefined) this._namespace = updates.namespace;\n    }\n    /**\n     * Generates the embedding for the definition's source and metadata. \n     * \n     * @param scope \n     * @returns \n     */\n    embed(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameDefinitionFeatures.Embed, scope);\n    }\n\n\n    fromNew(newEntity: A_FrameDefinition_Init): void {\n        this._type = newEntity.type;\n\n        this.aseid = this.generateASEID({\n            id: A_FormatterHelper.toKebabCase(newEntity.dependency + '-' + newEntity.name),\n            scope: 'a-frame',\n        });\n\n        this._name = newEntity.name;\n\n        const hashSource = this._name + '//'\n            + (newEntity.description || '') + '//'\n            + (newEntity.metadata ? JSON.stringify(newEntity.metadata) : '') + '//'\n            + newEntity.source + '//'\n            + 'Namespace: ' + newEntity.namespace.id;\n\n        this._hash = A_FrameHashHelper.fnv1a(hashSource);\n\n        this._source = newEntity.source;\n        this._description = newEntity.description;\n        this._namespace = newEntity.namespace;\n        this._metadata = newEntity.metadata;\n        this._dependency = newEntity.dependency;\n        this._requestedModel = newEntity.model ?? A_FRAME_MODELS.ANTARES;\n    }\n\n    fromJSON(serialized: A_FrameDefinition_Serialized): void {\n        this._name = serialized.name;\n        this._hash = serialized.hash;\n        this._source = serialized.source || '';\n        this._description = serialized.description;\n        this._metadata = serialized.metadata;\n        this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : undefined;\n        this._date = serialized.date;\n        this._model = serialized.model;\n        this._credentialId = serialized.credentialId;\n        this._aFrameVersion = serialized.aFrameVersion;\n        this._aFrameServerVersion = serialized.aFrameServerVersion;\n        this._aFrameMeta = serialized.aFrameMeta;\n    }\n\n    toJSON(): A_FrameDefinition_Serialized {\n        return {\n            ...super.toJSON(),\n            hash: this._hash,\n            name: this._name,\n            source: this._source,\n            description: this._description,\n            metadata: this._metadata,\n            namespace: this._namespace.aseid.toString(),\n            embedding: this._vector?.values,\n            date: this._date ?? new Date().toISOString(),\n            model: this._model,\n            credentialId: this._credentialId,\n            aFrameVersion: this._aFrameVersion,\n            aFrameServerVersion: this._aFrameServerVersion,\n            aFrameMeta: this._aFrameMeta,\n        };\n    }\n\n\n    // ─── Embedding hydration ──────────────────────────────────────────────────\n\n    /** Populate the vector from a pre-existing storage record */\n    // hydrateFromRecord(record: A_FrameDefinition_Record): void {\n    //     if (record.hash !== this._hash) {\n    //         throw new Error(\n    //             `A_FrameDefinition.hydrateFromRecord: hash mismatch for \"${this._name}\" ` +\n    //             `(expected ${this._hash}, got ${record.hash})`\n    //         );\n    //     }\n    //     this._vector = new A_FrameVector(record.embedding);\n    //     this._embeddedAt = record.embeddedAt;\n    //     this._model = record.model;\n    //     this._credentialId = record.credentialId;\n    //     this._aFrameVersion = record.aFrameVersion;\n    //     this._aFrameServerVersion = record.aFrameServerVersion;\n    // }\n\n    /** Populate the vector from a freshly-fetched embedding */\n    hydrateFromEmbedding(embedding: Float32Array, meta?: A_FrameDefinition_EmbeddingMeta): void {\n        this._vector = new A_FrameVector(embedding);\n        this._date = new Date().toISOString();\n        if (meta) {\n            this._model = meta.model;\n            this._credentialId = meta.credentialId ?? undefined;\n            this._aFrameVersion = meta.aFrameVersion;\n            this._aFrameServerVersion = meta.aFrameServerVersion;\n            if (meta.aFrameMeta)\n                this._aFrameMeta = meta.aFrameMeta;\n        }\n    }\n\n    // ─── Embedding input ──────────────────────────────────────────────────────\n\n    /**\n     * Build the text string sent to the embedding model.\n     * Concatenates name + description + source so the resulting\n     * vector captures both intent and implementation.\n     */\n    toString(): string {\n        const parts: string[] = [];\n        parts.push(`// ${this._name}`);\n        if (this._description) parts.push(`// ${this._description}`);\n        parts.push(this._source);\n        return parts.join('\\n');\n    }\n}\n"]}